srv_wsendmsg (Extended Stored Procedure API)

Importante:
Esta característica se quitará en una versión futura de Microsoft SQL Server. No utilice esta característica en nuevos trabajos de desarrollo y modifique lo antes posible las aplicaciones que actualmente la utilizan. Use CLR integration instead.

Sends a Unicode message to the client.

Sintaxis

int srv_wsendmsg(SRV_PROC * 
srvproc
, int 
msgnum
, int 
severity
, WCHAR * 
message
, int 
msglen
);

Arguments

• srvproc
  Is a pointer to the SRV_PROC structure that is the handle for a particular client connection. The structure contains information the Extended Stored Procedure API library uses to manage communication and data between the application and the client.

• Msgnum
  Is a 4-byte message number.

• Severity
  Specifies the severity of the error. A severity less than or equal to 10 is considered an informational message; otherwise, it is an error.

• message
  Is a pointer to a Unicode string to be sent to the client.

• msglen
  Specifies the length, in characters, of message.

Returns

SUCCEED or FAIL.

Notas

Use this function to send messages in Unicode. It is similar to srv_sendmsg, but the message it sends is a WCHAR string rather than type DBCHAR string. Note that message length is reported in characters rather than bytes, and msglen will never be equal to SRV_NULLTERM.

The function returns FAIL when

• The msglen given is not in the range of 0-32242.
• The msglen given is 0 but the message pointer is NULL.
• There is error when sending the error message through network.

Nota de seguridad:
You should thoroughly review the source code of extended stored procedures, and you should test the compiled DLLs before you install them on a production server. For information about security review and testing, see this Microsoft Web site.

Vea también

Referencia

srv_sendmsg (Extended Stored Procedure API)

Ayuda e información

Obtener ayuda sobre SQL Server 2005