RpcBindingUnbind, fonction (rpcasync.h)
La fonction RpcBindingUnbind dissocie un handle de liaison précédemment lié par RpcBindingBind.
Syntaxe
RPC_STATUS RpcBindingUnbind(
[in] RPC_BINDING_HANDLE Binding
);
Paramètres
[in] Binding
RPC_BINDING_HANDLE structure qui contient le handle de liaison à dissocier du serveur RPC.
Valeur retournée
Cette fonction retourne RPC_S_OK en cas de réussite ; sinon, un code d’erreur RPC_S_* est retourné.
Notes
RpcBindingUnbind dissocie un handle de liaison précédemment lié d’un serveur RPC. Un handle indépendant peut être modifié avec des appels tels que RpcBindingSetOption et RpcBindingSetAuthInfoEx. Un handle de liaison à l’état indépendant peut être à nouveau lié et réutilisé pour effectuer des appels.
Les résultats d’une opération de dissociation ne sont pas définis si elle est appelée sur un handle de liaison qui a actuellement des appels RPC en cours au moment de la dissociation. Il incombe à l’appelant de s’assurer qu’aucun appel n’est en cours au moment où une opération de dissociage est tentée.
Notez que l’appel de RpcBindingUnbind ne déconnecte pas nécessairement le client du serveur. Elle invalide toutes les informations mises en cache utilisées par le handle de liaison, mais la déconnexion n’est pas garantie. Pour garantir la déconnexion, libérez le handle de liaison avec RpcBindingFree.
Windows Vista : Actuellement, cette fonction prend uniquement en charge la séquence de protocole ncalrpc .
Spécifications
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | rpcasync.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |