srv_wsendmsg (API do procedimento armazenado estendido)
Aplica-se: SQL Server
Importante
Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use a integração CLR em vez disso.
Envia uma mensagem de Unicode ao cliente.
Sintaxe
int srv_wsendmsg(SRV_PROC *
srvproc
, int
msgnum
, int
severity
, WCHAR *
message
, int
msglen
);
Argumentos
srvproc
É um ponteiro para a estrutura SRV_PROC que atua como identificador de uma conexão de cliente específica. 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.
Msgnum
É um número de mensagem de 4 bytes.
Gravidade
Especifica a gravidade do erro. Uma gravidade menor ou igual a 10 é considerada uma mensagem informativa. Caso contrário, trata-se de um erro.
message
É um ponteiro para a cadeia de caracteres de Unicode que será enviada ao cliente.
msglen
Especifica o comprimento, em caracteres, de message.
Devoluções
SUCCEED ou FAIL.
Comentários
Use esta função para enviar mensagens em Unicode. É semelhante a srv_sendmsg, mas a mensagem que envia é uma cadeia de caracteres de WCHAR em vez de uma cadeia de caracteres de DBCHAR. Observe que o comprimento da mensagem é informado em caracteres, e não em bytes, e que msglen nunca será igual a SRV_NULLTERM.
A função retorna FAIL quando
O msglen fornecido não está no intervalo de 0-32242.
O msglen fornecido é 0, mas o ponteiro de mensagem é o NULL.
Ocorre um erro ao enviar a mensagem de erro na rede.
Importante
Você deve examinar totalmente o código-fonte de procedimentos armazenados estendidos e deve 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.