srv_paramlen (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Devolve o comprimento de dados de um parâmetro de chamada de procedimento armazenado remoto. Esta função foi substituída pela função srv_paraminfo .

Syntax

  
int srv_paramlen (  
SRV_PROC *  
srvproc  
,  
int  
n   
);  

Arguments

srvproc
É um ponteiro para a estrutura SRV_PROC que é o handle para uma ligação cliente particular (neste caso, o handle que recebeu a chamada remota ao procedimento armazenado). A estrutura contém informação que a biblioteca da API de Procedimentos Armazenados Estendidos utiliza para gerir a comunicação e os dados entre a aplicação e o cliente.

n
Indica o número do parâmetro. O primeiro parâmetro é 1.

Devoluções

O comprimento real, em bytes, dos dados do parâmetro. Se não houver um parâmetro n-ésimoou um procedimento armazenado remoto, devolve -1. Se o n-ésimoparâmetro for NULO, devolve 0.

Esta função devolve os seguintes valores, se o parâmetro for um dos seguintes tipos de dados do sistema Microsoft SQL Server 2005 (9.x).

* len real = Comprimento da cadeia de caracteres multibyte (cch)

Observações

Cada parâmetro de procedimento armazenado remoto tem um comprimento real e um comprimento máximo de dados. Para tipos de dados padrão de comprimento fixo que não permitem valores nulos, os comprimentos real e máximo são os mesmos. Para tipos de dados de comprimento variável, os comprimentos podem variar. Por exemplo, um parâmetro declarado como varchar(30) pode ter dados com apenas 10 bytes. O comprimento real do parâmetro é 10 e o seu comprimento máximo é 30. A função srv_paramlen obtém o comprimento real dos dados, em bytes, de um procedimento armazenado remotamente. Para obter o comprimento máximo de dados de um parâmetro, use srv_parammaxlen.

Quando é feita uma chamada remota de procedimento armazenado com parâmetros, estes podem ser passados por nome ou por posição (não nomeada). Se a chamada remota ao procedimento armazenado for feita com alguns parâmetros passados pelo nome e outros passados pela posição, ocorre um erro. O handler de SRV_RPC continua a ser chamado, mas parece que não houve parâmetros e srv_rpcparams devolve 0.

Conteúdo relacionado

• srv_paraminfo (API de Procedimentos Armazenados Estendidos)
• srv_rpcparams (API de Procedimentos Armazenados Estendidos)