Compartilhar via

Função RpcBindingUnbind (rpcasync.h)

  • Artigo

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.

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

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

   
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcasync.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcBindingBind

RpcBindingFree