Share via

  • Artigo

srv_senddone (API de procedimento armazenado estendido)

Observação importanteImportante

Esse recurso será removido em uma versão futura de Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e planeje modificar, assim que possível, 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.

Retorna

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.

Observação sobre segurançaObservação sobre segurança

Você deve examinar cuidadosamente o código-fonte de procedimentos armazenados estendidos e 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.