srv_rpcname (API de procedimento armazenado estendido)

Importante
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 componente de nome de procedimento para o procedimento armazenado remoto atual.

Sintaxe

DBCHAR * srv_rpcname (
SRV_PROC *
srvproc
,
int *
len 
);

Argumentos

• srvproc
  É um ponteiro para a estrutura SRV_PROC que é o identificador de uma conexão de cliente específica (neste caso, o identificador que recebeu o 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.

• len
  É um ponteiro para uma variável inteira que recebe o comprimento do nome do banco de dados. Se len for NULL, o comprimento do nome do procedimento armazenado remoto não será retornado.

Retorna

Um ponteiro DBCHAR para a cadeia de caracteres com terminação nula do componente de nome de procedimento armazenado remoto do procedimento armazenado remoto atual. Se não houver um procedimento armazenado remoto atual, NULL será retornado e len será definido como -1.

Comentários

Essa função retorna apenas o nome do procedimento armazenado remoto. Ela não inclui os especificadores opcionais para proprietário, nome do banco de dados e número do procedimento armazenado remoto.

Como é válido chamar srv_rpcname quando não existe um procedimento armazenado remoto (nenhum erro informativo ocorre), essa função fornece um método para determinar se um procedimento armazenado remoto existe.

Observaçã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.