srv_setcoldata (API de procedimento armazenado estendido)
Aplica-se: 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.
Devoluções
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.