srv_paramnumber (API de Procedimentos Armazenados Estendidos)

Aplica-se a: SQL Server

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Usa antes a integração CLR.

Devolve o número de um parâmetro de chamada de procedimento armazenado remoto.

Syntax

  
int srv_paramnumber (  
SRV_PROC *  
srvproc  
,  
DBCHAR *  
name  
,   
int  
namelen   
);  

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.

name
É um apontador para o nome do parâmetro.

Namelen
É o comprimento do nome. Se name estiver terminado por null, defina namelen para SRV_NULLTERM.

Devoluções

O número do parâmetro do parâmetro nomeado. O primeiro parâmetro é 1. Se não houver nome de parâmetro ou procedimento armazenado remoto, 0 é devolvido e é gerada uma mensagem.

Observações

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.

Importante

Deves rever cuidadosamente o código-fonte dos procedimentos armazenados estendidos e deves testar as DLLs compiladas antes de as instalares num servidor de produção. Para informações sobre revisão e testes de segurança, consulte este site da Microsoft.