srv_paramname (API de procedimento armazenado estendido)

Aplica-se a:SQL Server

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use a integração CLR em vez disso.

Retorna o nome de um parâmetro de chamada de procedimento armazenado remoto.

Sintaxe

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

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.

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 tamanho, em bytes, do nome do parâmetro. Se len for NULL, o tamanho do nome do parâmetro do procedimento armazenado remoto não será retornado.

Retornos

Um ponteiro para uma cadeia de caracteres com terminação nula que contém o nome do parâmetro. O tamanho do nome do parâmetro é armazenado em len. Se não houver n-ésimo parâmetro nem um procedimento armazenado remoto, será retornado NULL, len será definido como -1 e uma mensagem de erro informativa será enviada. Se o nome do parâmetro for o NULL, len será definido como 0 e uma cadeia de caracteres vazia que termina em nulo será retornada.

Comentários

Essa função obtém o nome de um parâmetro de chamada de procedimento armazenado remoto. 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 é chamado, mas aparece como se não houvesse parâmetros e srv_rpcparams retorna 0.

Importante

Você deve examinar totalmente o código-fonte de procedimentos armazenados estendidos e deve 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.

Confira também

srv_rpcparams (API de procedimento armazenado estendido)