srv_senddone (API de 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 conclusão de resultado para o cliente.

Sintaxe

  
int srv_senddone (  
SRV_PROC *  
srvproc  
,  
DBUSMALLINT   
status  
,  
DBUSMALLINT  
info  
,  
DBINT  
count   
);  
  

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.

status
É um campo de 2 bytes para vários sinalizadores status . Vários sinalizadores podem ser definidos usando os operadores lógicos AND e OR com valores de sinalizador status . A seguinte tabela lista os possíveis sinalizadores status .

Sinalizador de status	Descrição
SRV_DONE_COUNT	O parâmetro count contém uma contagem válida.
SRV_DONE_ERROR	O comando do cliente atual recebeu um erro.

info
É um campo reservado de 2 bytes. Defina o valor como 0.

count
É um campo de 4 bytes usado para indicar uma contagem do conjunto de resultados atual. Se o sinalizador SRV_DONE_COUNT for definido no campo status , count manterá uma contagem válida.

Retornos

SUCCEED ou FAIL

Comentários

Uma solicitação do cliente pode fazer com que o servidor execute vários comandos e retorne vários conjuntos de resultados. Para cada conjunto de resultados, srv_senddone deve retornar uma mensagem de conclusão de resultado para o cliente.

O campo count indica o número de linhas afetadas por um comando. Se o campo count contiver uma contagem, o sinalizador SRV_DONE_COUNT deverá ser definido no campo status . Essa configuração permite ao cliente distinguir entre um valor count igual a 0 e um campo não usado count .

Não chame srv_senddone no manipulador SRV_CONNECT.

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.