Função RpcBindingReset (rpcdce.h)

A função RpcBindingReset redefine um identificador de associação para que o host seja especificado, mas o servidor nesse host não seja especificado.

Sintaxe

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

Parâmetros

Binding

Identificador de associação de servidor a ser redefinido.

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 era 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 cliente chama a função RpcBindingReset para desassociar uma instância de servidor específica do identificador de associação de servidor especificado no parâmetro Binding . A função RpcBindingReset desassocia uma instância de servidor removendo a parte do ponto de extremidade do endereço do servidor no identificador de associação. O host permanece inalterado no identificador de associação. O resultado é um identificador de associação de servidor parcialmente associado.

RpcBindingReset não afeta as informações de autenticação do parâmetro Binding , se houver alguma.

Se um cliente estiver disposto a ser atendido por qualquer instância de servidor compatível no host especificado no identificador de associação, o cliente chamará a função RpcBindingReset antes de fazer uma chamada de procedimento remoto usando o identificador de associação binding . Os clientes não devem chamar a função RpcBindingReset para identificadores de associação nos quais as chamadas estão sendo executadas.

Quando o cliente faz a próxima chamada de procedimento remoto usando a associação de redefinição (parcialmente associada), a biblioteca de tempo de execução RPC do cliente usa um ponto de extremidade conhecido da especificação de interface do cliente, se houver. Caso contrário, a biblioteca em tempo de execução do cliente se comunica automaticamente com o serviço de mapeamento de ponto de extremidade no host remoto especificado para obter o ponto de extremidade de um servidor compatível do banco de dados de mapa de ponto de extremidade. Se um servidor compatível estiver localizado, a biblioteca de tempo de execução RPC atualizará a associação com um novo ponto de extremidade. Se um servidor compatível não for encontrado, a chamada de procedimento remoto falhará. Para chamadas que usam um protocolo de conexão (ncacn), o código EPT_S_NOT_REGISTERED status é retornado ao cliente. Para chamadas que usam um protocolo de datagrama (ncadg), o código RPC_S_COMM_FAILURE status é retornado ao cliente.

Os aplicativos de servidor devem registrar todos os identificadores de associação chamando RpcEpRegister e RpcEpRegisterNoReplace se o servidor quiser estar disponível para clientes que fazem uma chamada de procedimento remoto em um identificador de associação de redefinição.

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

RpcEpRegister

RpcEpRegisterNoReplace