srv_setcollen (API de procedimento armazenado estendido)
.gif "Observação importante") Importante |
|---|
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, 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.
Retorna
SUCCEED ou FAIL.
Comentários
Cada coluna da linha deve ser definida primeiro com srv_describe. O comprimento dos dados da coluna é definido pela última chamada para srv_describe ou srv_setcollen. Se dados de comprimento variável (dados com terminação nula) forem alterados em uma linha, srv_setcollen deverá ser usado para defini-los com o novo comprimento antes de chamar srv_sendrow. No caso de uma coluna que aceita valores nulos, srv_describe deve ter sido chamado com desttype definido como um tipo de dados que aceita nulos (como SRVINTN) e dados nulos são especificados chamando-se 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.
.gif "Observação sobre segurança") Observaçã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. |