srv_wsendmsg (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 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.

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

Retorna

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.

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.

Consulte também

Referência

srv_sendmsg (API do procedimento armazenado estendido)