srv_paramname (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Devolve o nome de um parâmetro de chamada de procedimento armazenado remotamente.

Syntax

  
DBCHAR * srv_paramname (  
SRV_PROC * srvproc,intn, int *len );  

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 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.

len
Fornece um ponteiro para uma variável int que contém o comprimento, em bytes, do nome do parâmetro. Se o len for NULL, o comprimento do nome do parâmetro do procedimento armazenado remoto não é devolvido.

Devoluções

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do parâmetro. O comprimento do nome do parâmetro é armazenado em len. Se não houver n-ésimoparâmetro ou procedimento armazenado remoto, devolve NULL, o len é definido para -1 e é enviada uma mensagem de erro informativa. Se o nome do parâmetro for NULL, len é definido para 0 e uma cadeia vazia terminada por nulo é devolvida.

Observações

Esta função recebe o nome de um parâmetro de chamada de procedimento armazenado remotamente. 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 ainda é chamado, mas parece que não havia parâmetros, e srv_rpcparams devolve 0.

Conteúdo relacionado

• srv_rpcparams (API de Procedimentos Armazenados Estendidos)