Fonction RpcSsDestroyClientContext (rpcndr.h)

  • Article

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.

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

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

Voir aussi

RpcBindingReset

RpcSmDestroyClientContext