srv_wsendmsg (API do procedimento armazenado estendido)

Aplica-se a: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.

Retornos

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.

Confira também

srv_sendmsg (API do procedimento armazenado estendido)