srv_wsendmsg (API de procedimiento almacenado extendido)

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. En su lugar, use la integración 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.

• Severity
  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.

Devuelve

SUCCEED o FAIL.

Notas

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.

Nota de seguridad
Debe revisar cuidadosamente 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.

Vea también

Referencia

srv_sendmsg (API de procedimiento almacenado extendido)