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

Especifica o endereço atual dos dados de uma coluna.

Sintaxe

  
int srv_setcoldata (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
void *  
data   
);  

Argumentos

srvproc
É um ponteiro para a estrutura SRV_PROC que atua como identificador de uma conexão de cliente específica. 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.

column
Indica o número da coluna para a qual o endereço está sendo especificado. As colunas são numeradas a partir de 1.

data
É um ponteiro para os dados de uma coluna. A memória alocada para data não deve ser liberada até que os dados da coluna sejam substituídos por outra chamada para srv_setcoldata, ou até que srv_senddone seja chamado.

Retornos

SUCCEED ou FAIL.

Comentários

Cada coluna da linha deve ser definida primeiro com srv_describe. Os endereços dos dados da coluna são definidos inicialmente com srv_describe. Se o endereço dos dados da coluna for alterado, srv_setcoldata deverá ser chamado para especificar o novo endereço e srv_setcoldata deverá ser chamado separadamente para cada coluna alterada.

Os dados nulos são representados definindo-se o comprimento da coluna como 0 com srv_setcollen. Portanto, o endereço dos dados é ignorado.

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)