Compartilhar via


Função RpcEpResolveBinding (rpcdce.h)

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

Confira também

RpcBindingFromStringBinding

RpcBindingReset

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingImportBegin

RpcNsBindingImportDone

RpcNsBindingImportNext