Função RpcEpResolveBinding (rpcdce.h)

Artigo
08/25/2023

A função RpcEpResolveBinding resolve um identificador de associação de servidor parcialmente associado em um identificador de associação de servidor totalmente associado.

Sintaxe

RPC_STATUS RpcEpResolveBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_HANDLE      IfSpec
);

Parâmetros

Binding

Identificador de associação de servidor parcialmente associado a resolve a um identificador de associação de servidor totalmente associado.

IfSpec

Estrutura gerada por Stub que especifica a interface de interesse.

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING	O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING	Esse foi o tipo errado de associação para a operação.

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

Comentários

Um aplicativo chama a função RpcEpResolveBinding para resolve um identificador de associação de servidor parcialmente associado em um identificador de associação totalmente associado.

Resolver identificadores de associação requer uma UUID de interface e um UUID de objeto (que pode ser zero). A biblioteca de tempo de execução RPC solicita que o serviço de mapeamento de ponto de extremidade no host especificado pelo parâmetro Binding procure uma instância de servidor compatível. Para localizar o ponto de extremidade, o serviço de mapeamento de ponto de extremidade procura no banco de dados de mapa de ponto de extremidade a interface UUID no parâmetro IfSpec e o objeto UUID no parâmetro Binding , se houver.

A forma como a operação de associação de resolve funciona depende se o identificador de associação especificado está parcial ou totalmente associado. Quando o cliente especifica um identificador parcialmente associado, a operação de associação de resolve tem os seguintes resultados possíveis:

Se nenhuma instância de servidor compatível for registrada no banco de dados de mapa de ponto de extremidade, a operação de associação de resolve retornará o código EPT_S_NOT_REGISTERED status.
Se uma instância de servidor compatível for registrada no banco de dados de mapa de ponto de extremidade, a operação de associação de resolve retornará uma associação totalmente associada e o código RPC_S_OK status.

Quando o cliente especifica um identificador de associação totalmente associado, a operação de associação de resolve retorna o identificador de associação especificado e o código RPC_S_OK status. A operação de associação de resolve não entra em contato com o serviço de mapeamento de ponto de extremidade.

No caso de associação parcial ou totalmente associada, a operação de associação de resolve entra em contato com uma instância de servidor compatível.

Nota Chamar RpcEpResolveBinding não é estritamente necessário. Se uma chamada RPC for feita em um identificador de associação de servidor parcialmente associado, o tempo de execução do RPC executará as etapas necessárias para tornar a associação em um identificador de associação totalmente associado. O tempo de execução do RPC chama RpcEpResolveBinding, mas o faz com mais eficiência devido a técnicas de cache adicionais. No Windows XP e no Windows 2000, os aplicativos não têm motivos para chamar RpcEpResolveBinding.

Requisitos


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