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.
Devoluções
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.