srv_setcollen (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Especifica o comprimento atual dos dados em bytes de uma coluna de comprimento variável ou de uma coluna que permita valores NULL.

Syntax

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

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 comprimento dos dados está a ser especificado. As colunas são numeradas começando por 1.

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

Devoluções

TER SUCESSO ou FALHAR.

Observações

Cada coluna da linha deve primeiro ser definida com srv_describe. O comprimento dos dados da coluna é definido pela última chamada para srv_describe ou srv_setcollen. Se os dados de comprimento variável (dados terminados por nulos) mudarem para uma linha, srv_setcollen devem ser usados para definir o novo comprimento antes de chamar srv_sendrow. Para uma coluna que permite valores nulos, srv_describe deve ter sido chamada com desttype definido para um tipo de dado que permita nulos (como SRVINTN) e dados nulos são especificados chamando srv_setcollen com len definido a 0. Dados de comprimento zero não podem ser especificados usando a API de Procedimentos Armazenados Estendidos.

Note que quando o tipo de dado da coluna é de comprimento variável, o len não é assinalado. Esta função devolve FAIL se chamada para uma coluna de comprimento fixo.

Conteúdo relacionado

• srv_describe (API de Procedimentos Armazenados Estendidos)