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

Transmite uma linha de dados ao cliente.

Sintaxe

  
int srv_sendrow ( SRV_PROC *  
srvproc   
);  

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.

Retornos

SUCCEED ou FAIL.

Comentários

A função srv_sendrow é chamada uma vez para cada linha enviada ao cliente. Todas as linhas devem ser enviadas ao cliente antes de qualquer mensagem, valor de status ou status de conclusão ser enviado com srv_sendmsg, srv_statusou srv_senddone.

O envio de uma linha que não tenha tido todas as suas colunas definidas com srv_describe faz com que o aplicativo da API de Procedimento Armazenado Estendido crie uma mensagem de erro informativa e retorne FAIL ao cliente. Neste caso, a linha não é enviada.

Observação

A API de Procedimento Armazenado Estendido não dá suporte ao envio de linhas computadas ao cliente. Além disso, se uma linha que contenha dados ntext, textou image for enviada ao cliente, o ponteiro de texto e o carimbo de data/hora de texto não serão incluídos.

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.

Confira também

srv_describe (API de procedimento armazenado estendido)