Compartilhar via


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

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.

Retorna

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.

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.