RpcBindingFree, fonction (rpcdce.h)

Article
08/25/2023

La fonction RpcBindingFree libère des ressources binding-handle.

Syntaxe

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Paramètres

Binding

Pointeur vers la liaison de serveur à libérer.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Notes

La fonction RpcBindingFree libère la mémoire utilisée par un handle de liaison de serveur. Les informations de liaison référencées qui ont été créées dynamiquement pendant l’exécution du programme sont également publiées. Une application appelle la fonction RpcBindingFree lorsqu’elle a terminé d’utiliser le handle de liaison. Les handles de liaison RPC ne doivent pas être libérés tant que tous les appels utilisant le handle ne sont pas terminés ; si vous ne le faites pas, les résultats sont imprévisibles.

Les handles de liaison sont créés dynamiquement en appelant les fonctions suivantes :

Si l’opération libère correctement la liaison, le paramètre Binding retourne la valeur NULL.

Note Microsoft RPC prend en charge RpcBindingFree uniquement dans les applications clientes ou dans les applications serveur pour les handles de liaison générés avec RpcBindingServerFromClient.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll