srv_sendmsg (API do procedimento armazenado estendido)

Importante
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Use a integração CLR em vez disso.

Envia uma mensagem ao cliente.

Sintaxe

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
  É um ponteiro para a estrutura SRV_PROC que é o identificador de uma conexão de cliente específica (neste caso, o identificador que recebeu a solicitação de linguagem). A estrutura contém informações que a biblioteca de APIs de procedimento armazenado estendido usa para gerenciar a comunicação e os dados entre o aplicativo e o cliente.

• msgtype
  É SRV_MSG_INFO ou SRV_MSG_ERROR, dependendo se o servidor está enviando uma mensagem informativa ou de erro.

• msgnum
  É um número de mensagem de 4 bytes.

• class
  Especifica a gravidade do erro. Uma gravidade menor ou igual a 10 é considerada uma mensagem informativa.

• state
  Fornece o número do estado de erro para a mensagem atual. O número do estado de erro fornece informações sobre o contexto do erro. Os números de estado válidos variam de 0 a 255.

• rpcname
  Atualmente ele não tem suporte.

• rpcnamelen
  Atualmente ele não tem suporte.

• linenum
  É o número da linha no lote de comando de linguagem onde a mensagem é aplicada. Os números da linha iniciam em 1. Se linenum não se aplicar à mensagem, defina como 0.

• message
  É um ponteiro para a cadeia de caracteres que será enviada ao cliente.

• msglen
  Especifica o comprimento, em bytes, de message. Se message tiver terminação null, defina msglen como SRV_NULLTERM.

Retorna

SUCCEED ou FAIL

Comentários

Essa função envia mensagens de erro ou informativas ao cliente. Ela é chamada uma vez para cada mensagem que será enviada.

É possível enviar mensagens ao cliente com srv_sendmsg em qualquer ordem antes ou depois que todas as linhas (se houver) tiverem sido enviadas com srv_sendrow. Todas as mensagens, se houver, devem ser enviadas ao cliente antes do envio do status de conclusão com srv_senddone.

Para enviar mensagens em Unicode, use srv_wsendmsg no lugar de srv_sendmsg.

Para obter mais informações, consulte Páginas de código do servidor e dados Unicode.

Observação sobre segurança
Você deve examinar cuidadosamente o código-fonte de procedimentos armazenados estendidos e testar as DLLs compiladas antes de instalá-las em um servidor de produção. Para obter informações sobre revisão e testes de segurança, consulte este site da Microsoft.