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
| 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 |