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 |
---|---|
|
A chamada foi bem-sucedida. |
|
O identificador de associação era inválido. |
|
Esse era o tipo errado de associação para a operação. |
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 |