srv_sendmsg (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 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-o como 0.

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

msglen
Especifica o tamanho, em bytes, de message. Se message terminar em nulo, defina msglen como SRV_NULLTERM.

Devoluções

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.

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.