srv_sendmsg (API de procedimiento almacenado extendido)

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.

• class
  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
  Actualmente no se admite.

• rpcnamelen
  Actualmente no se admite.

• 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, establézcalo 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.

Devuelve

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 hay) con srv_sendrow. Todos los mensajes, si los hay, se deben enviar al cliente antes de enviar el estado de finalización con srv_senddone.

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

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

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.