srv_wsendmsg (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Important

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Usa antes a integração CLR.

Envia uma mensagem Unicode ao cliente.

Syntax

  
int srv_wsendmsg(SRV_PROC *   
srvproc  
, int   
msgnum  
, int   
severity  
, WCHAR *   
message  
, int   
msglen  
);

Arguments

srvproc
É um apontador para a estrutura SRV_PROC que é o handler para uma ligação cliente particular. A estrutura contém informação que a biblioteca API de Procedimentos Armazenados Estendidos utiliza para gerir a comunicação e os dados entre a aplicação e o cliente.

Msgnum
É um número de mensagem de 4 bytes.

Gravidade
Especifica a gravidade do erro. Uma gravidade inferior ou igual a 10 é considerada uma mensagem informativa; caso contrário, é um erro.

message
É um apontador para uma string Unicode a ser enviada ao cliente.

msglen
Especifica o comprimento, em caracteres, da mensagem.

Devoluções

TER SUCESSO ou FALHAR.

Observações

Use esta função para enviar mensagens em Unicode. É semelhante ao srv_sendmsg, mas a mensagem que envia é uma string WCHAR em vez de string do tipo DBCHAR. Note que o comprimento da mensagem é reportado em caracteres em vez de bytes, e o msglen nunca será igual a SRV_NULLTERM.

A função devolve FAIL quando

  • O msglen dado não está no intervalo de 0-32242.

  • O msglen dado é 0, mas o ponteiro da mensagem é NULL.

  • Há erro ao enviar a mensagem de erro através da rede.

Important

Deves rever cuidadosamente o código-fonte dos procedimentos armazenados estendidos e deves testar as DLLs compiladas antes de as instalares num servidor de produção. Para informações sobre revisão e testes de segurança, consulte este site da Microsoft.

Conteúdo relacionado

  • Last updated on