srv_setcollen (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 comprimento dos dados em bytes de uma coluna de comprimento variável ou de uma coluna que aceita valores NULL.

Sintaxe

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);  

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 comprimento dos dados está sendo especificado. As colunas são numeradas a partir de 1.

len
Indica o comprimento, em bytes, dos dados da coluna. Um comprimento igual a 0 significa que o valor dos dados da coluna é nulo.

Retornos

SUCCEED ou FAIL.

Comentários

Cada coluna da linha deve ser definida primeiro com srv_describe. O tamanho dos dados da coluna é definido pela última chamada a srv_describe ou srv_setcollen. Se os dados de comprimento variável (dados que terminam em nulo) forem alterados em uma linha, srv_setcollen deverá ser usado para defini-los com o novo tamanho antes de chamar srv_sendrow. No caso de uma coluna que aceita valores nulos, srv_describe deve ter sido chamado com desttype definido com um tipo de dados que aceita nulos (como SRVINTN) e dados nulos são especificados chamando srv_setcollen com len definido como 0. Os dados com comprimento zero não podem ser especificados com a API de procedimento armazenado estendido.

Observe que quando o tipo de dados da coluna tem comprimento variável, len não é verificado. Essa função retornará FAIL se for chamada para uma coluna de comprimento fixo.

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)