srv_setcoldata (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Usa antes a integração CLR.

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

Syntax

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

Arguments

srvproc
É um apontador para a estrutura SRV_PROC que é o handler para uma ligação cliente particular. A estrutura contém informação que a biblioteca API de Procedimentos Armazenados Estendidos utiliza para gerir a comunicação e os dados entre a aplicação e o cliente.

coluna
Indica o número da coluna para a qual o endereço está a ser especificado. As colunas são numeradas começando por 1.

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

Devoluções

TER SUCESSO ou FALHAR.

Observações

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

Dados nulos são representados definindo o comprimento da coluna para 0 com srv_setcollen. O endereço de dados é então ignorado.

Importante

Deves rever cuidadosamente o código-fonte dos procedimentos armazenados estendidos e deves testar as DLLs compiladas antes de as instalares num servidor de produção. Para informações sobre revisão e testes de segurança, consulte este site da Microsoft.

Conteúdo relacionado

  • Last updated on