srv_paramstatus (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 estado de um determinado parâmetro de chamada de procedimento armazenado remoto.

Syntax

  
int srv_paramstatus (  
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 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 é o número 1.

Devoluções

Um int que contém flags de estado para o parâmetro. Atualmente, existe apenas um flag: se o bit 0 estiver definido como 1, o parâmetro é um parâmetro de retorno. Se não houver n-ésimoparâmetro ou se não houver procedimento armazenado remotamente, devolve -1.

Observações

Esta rotina devolve os flags de estado para um parâmetro de chamada de procedimento armazenado remotamente.

Os parâmetros contêm dados passados entre clientes e a aplicação através de procedimentos armazenados remotos. O cliente pode especificar certos parâmetros como parâmetros de retorno. Estes parâmetros de retorno podem conter valores que a aplicação passa de volta ao cliente.

Atualmente, o único flag de estado é aquele que indica se o parâmetro é um parâmetro de retorno.

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. Se ocorrer um erro, o handler de SRV_RPC continua a ser 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.