Fonction RpcSsDestroyClientContext (rpcndr.h)
La fonction RpcSsDestroyClientContext détruit un handle de contexte dont le client n’a plus besoin, sans contacter le serveur.
Syntaxe
void RpcSsDestroyClientContext(
void **ContextHandle
);
Paramètres
ContextHandle
Handle de contexte à détruire. Le handle est défini sur NULL avant le retour de RpcSsDestroyClientContext .
Valeur retournée
RpcSsDestroyClientContext n’a aucune valeur de retour.
Remarques
RpcSsDestroyClientContext est utilisé par l’application cliente pour récupérer les ressources de mémoire utilisées pour gérer un handle de contexte sur le client. Cette fonction est utilisée lorsque ContextHandle n’est plus valide, par exemple lorsqu’un échec de communication s’est produit et que le serveur n’est plus disponible. Le handle de contexte est défini sur NULL. La fonction RpcSsDestroyClientContext fournit les mêmes fonctionnalités que la fonction RpcSmDestroyClientContext . Cette fonction n’appelle pas le processus d’exécution du handle de contexte du serveur.
N’utilisez pas RpcSsDestroyClientContext pour remplacer une fonction serveur qui ferme le handle de contexte.
La fonction RpcSsDestroyClientContext peut lever une exception RPC_X_SS_CONTEXT_MISMATCH si le handle de contexte qui lui a été transmis n’est pas valide. Les applications ne doivent jamais passer un handle de contexte non valide à cette fonction. Si une exception est levée, elle indique une erreur dans le code appelant et doit donc être examinée et corrigée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | rpcndr.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |