Compartir vía

srv_sendmsg (API de procedimiento almacenado extendido)

  • Artículo

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 al cliente.

Sintaxis

  
int srv_sendmsg (  
SRV_PROC *  
srvproc  
,  
int  
msgtype  
,  
DBINT  
msgnum  
,  
DBTINYINT  
class  
,   
DBTINYINT  
state  
,  
DBCHAR *  
rpcname  
,  
int   
rpcnamelen  
,  
DBUSMALLINT  
linenum  
,  
DBCHAR *  
message  
,  
int  
msglen   
);

Argumentos

srvproc
Es un puntero a la estructura SRV_PROC, que es el identificador de una conexión de cliente determinada (en este caso, el identificador que recibió la solicitud de idioma). La estructura contiene información que la biblioteca de API Procedimiento almacenado extendido utiliza para administrar la comunicación y los datos entre la aplicación y el cliente.

msgtype
Es SRV_MSG_INFO o SRV_MSG_ERROR, dependiendo de si el servidor está enviando un mensaje informativo o de error.

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

clase
Especifica la gravedad del error. Una gravedad menor o igual a 10 se considera un mensaje informativo.

state
Proporciona el número de estado de error para el mensaje actual. El número de estado de error proporciona información sobre el contexto del error. Los números de estado van de 0 a 255.

rpcname
No se admite actualmente.

rpcnamelen
No se admite actualmente.

linenum
Es el número de línea en el lote de comandos del lenguaje donde se aplica el mensaje. Los números de línea empiezan por 1. Si linenum no se aplica al mensaje, se establece en 0.

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

msglen
Especifica la longitud en bytes de message. Si message está terminado en null, establezca msglen en SRV_NULLTERM.

Devoluciones

SUCCEED o FAIL

Comentarios

Esta función envía mensajes de error o informativos al cliente. Se llama una vez por cada mensaje que se va a enviar.

Los mensajes se pueden enviar al cliente con srv_sendmsg en cualquier orden antes o después de haber enviado todas las filas (si las hubiera) con srv_sendrow. Todos los mensajes, si los hubiera, se deben enviar al cliente antes de enviar el estado de finalización con srv_senddone.

Para enviar mensajes en Unicode, use srv_wsendmsg en lugar de srv_sendmsg.

Para más información, vea Datos Unicode y páginas de códigos de servidor.

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.