Função RpcServerInqBindings (rpcdce.h)

Artigo
08/25/2023

A função RpcServerInqBindings retorna os identificadores de associação sobre os quais chamadas de procedimento remoto podem ser recebidas.

Sintaxe

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

Parâmetros

BindingVector

Retorna um ponteiro para um ponteiro para um vetor de identificadores de associação de servidor.

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_NO_BINDINGS	Não há associações.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

Um aplicativo de servidor chama RpcServerInqBindings para obter um vetor de identificadores de associação de servidor. A biblioteca de tempo de execução RPC cria identificadores de associação quando um aplicativo de servidor chama as seguintes funções para registrar sequências de protocolo:

O vetor de associação retornado pode conter identificadores de associação com pontos de extremidade dinâmicos ou identificadores de associação com pontos de extremidade conhecidos, dependendo de qual das funções acima o aplicativo de servidor chamou.

Um servidor usa o vetor de identificadores de associação para exportar para o serviço de nome, para registrar com o banco de dados local do mapa de ponto de extremidade ou para conversão em associações de cadeia de caracteres. Se não houver identificadores de associação (nenhuma sequência de protocolo registrada), essa rotina retornará o código RPC_S_NO_BINDINGS status e um valor de parâmetro BindingVector de NULL. O servidor é responsável por chamar a função RpcBindingVectorFree para liberar a memória usada pelo vetor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll