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.
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.
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.