Compartilhar via


srv_paramnumber (API de procedimento armazenado estendido)

Observação importanteImportante

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.

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

Sintaxe


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

Argumentos

  • srvproc
    É um ponteiro para a estrutura SRV_PROC que identifica uma conexão de cliente específica (nesse caso, o identificador que recebeu a chamada do procedimento armazenado remoto). 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.

  • name
    É um ponteiro para o name do parâmetro.

  • namelen
    É o comprimento total de name. Se name tiver terminação null, defina namelen como SRV_NULLTERM.

Retorna

O número do parâmetro nomeado. O primeiro parâmetro é 1. Se não houver nenhum parâmetro nomeado como name ou nenhum procedimento armazenado remoto, o retorno é 0 e uma mensagem é gerada.

Comentários

Quando uma chamada de procedimento armazenado remoto é feita com parâmetros, os parâmetros podem ser passados pelo nome ou pela posição (sem nome). Se a chamada de procedimento armazenado remoto for feita com alguns parâmetros transmitidos pelo nome e outros pela posição, ocorrerá um erro. O manipulador SRV_RPC ainda será chamado, mas aparecerá como se não houvesse parâmetros e srv_rpcparams retornará 0.

Observação sobre segurançaObservaçã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.