Função RpcBindingUnbind (rpcasync.h)

A função RpcBindingUnbind desvinca um identificador de associação anteriormente associado por RpcBindingBind.

Sintaxe

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

Parâmetros

[in] Binding

RPC_BINDING_HANDLE estrutura que contém o identificador de associação a ser desassociado do servidor RPC.

Valor retornado

Essa função retorna RPC_S_OK com êxito; caso contrário, um código de erro RPC_S_* será retornado.

Comentários

RpcBindingUnbind desassocia um identificador de associação associado anteriormente de um servidor RPC. Um identificador não associado pode ser modificado com chamadas como RpcBindingSetOption e RpcBindingSetAuthInfoEx. Um identificador de associação no estado não associado pode ser associado novamente e usado novamente para fazer chamadas.

Os resultados de uma operação não vinculada serão indefinidos se forem chamados em um identificador de associação que atualmente tem chamadas RPC em andamento no momento da desvinmação. É responsabilidade do chamador garantir que nenhuma chamada esteja em andamento no momento em que uma operação desassociada for tentada.

Observe que chamar RpcBindingUnbind não necessariamente desconecta o cliente do servidor. Ele invalidará todas as informações armazenadas em cache usadas pelo identificador de associação, mas, na verdade, a desconexão não é assegurada. Para garantir a desconexão, libere o identificador de associação com RpcBindingFree.

Windows Vista: Atualmente, essa função dá suporte apenas à sequência de protocolo ncalrpc .

Requisitos

Confira também

RpcBindingBind

RpcBindingFree