srv_senddone (API de procedimento armazenado estendido)

Aplica-se: SQL Server

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 .

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.

Devoluções

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.