Compartir vía


srv_wsendmsg (API de procedimiento almacenado extendido)

Se aplica a: SQL Server

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use la integración de CLR.

Envía un mensaje Unicode al cliente.

Sintaxis

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

Argumentos

srvproc
Es un puntero a la estructura SRV_PROC que es el identificador de una conexión cliente determinada. La estructura contiene información que la biblioteca de API de procedimiento almacenado extendido usa para administrar la comunicación y los datos entre la aplicación y el cliente.

Msgnum
Es un número de mensaje de 4 bytes.

Gravedad
Especifica la gravedad del error. Una gravedad menor o igual que 10 se considera un mensaje informativo; de lo contrario, se considera un error.

message
Es un puntero a una cadena Unicode que se va a enviar al cliente.

msglen
Especifica la longitud en caracteres de message.

Devoluciones

SUCCEED o FAIL.

Comentarios

Utilice esta función para enviar mensajes en Unicode. Es similar a srv_sendmsg, pero el mensaje que envía es una cadena WCHAR en lugar de una cadena de tipo DBCHAR. Tenga en cuenta que la longitud del mensaje se indica en caracteres en lugar de en bytes y que msglen nunca será igual a SRV_NULLTERM.

La función devuelve FAIL cuando

  • El argumento msglen proporcionado no está comprendido en el intervalo de 0 a 32242.

  • El argumento msglen proporcionado es 0 pero el puntero del mensaje es NULL.

  • Se produce un error al enviar el mensaje de error a través de la red.

Importante

Debe revisar minuciosamente el código fuente de los procedimientos almacenados extendidos y debe probar las DLL compiladas antes de instalarlas en el servidor de producción. Para obtener información acerca de la revisión y pruebas de seguridad, vea este sitio web de Microsoft.

Consulte también

srv_sendmsg (API de procedimiento almacenado extendido)