RpcServerUnregisterIfEx, fonction (rpcdce.h)

Article
03/04/2024

La fonction RpcServerUnregisterIfEx supprime une interface du registre de la bibliothèque d’exécution RPC. Cette fonction étend les fonctionnalités de la fonction RpcServerUnregisterIf .

Syntaxe

RPC_STATUS RpcServerUnregisterIfEx(
  [in] RPC_IF_HANDLE IfSpec,
  [in] UUID          *MgrTypeUuid,
  [in] int           RundownContextHandles
);

Paramètres

[in] IfSpec

Interface à supprimer du Registre.

Spécifiez une valeur Null pour supprimer toutes les interfaces précédemment inscrites avec la valeur UUID de type spécifiée dans le paramètre MgrTypeUuid .

[in] MgrTypeUuid

Pointeur vers le type UUID du vecteur de point d’entrée (EPV) du gestionnaire à supprimer du Registre. La valeur de MgrTypeUuid doit être la même que celle fournie dans un appel à la fonction RpcServerRegisterIf , à la fonction RpcServerRegisterIf2 ou à la fonction RpcServerRegisterIfEx .

Spécifiez une valeur Null pour supprimer l’interface spécifiée dans le paramètre IfSpec pour tous les UUID de type précédemment inscrits du Registre.

Spécifiez un UUID nil pour supprimer l’EPV de gestionnaire par défaut généré par MIDL du Registre. Dans ce cas, tous les APE de gestionnaire inscrits avec un UUID de type non nil restent inscrits.

[in] RundownContextHandles

Spécifie si l’exécution est appelée pour les handles de contexte actifs. Si la valeur est différente de zéro, l’exécution est appelée une fois que tous les appels sur l’interface sont terminés. S’il est défini sur zéro, l’exécution rpc suppose que le serveur a déjà détruit sa partie du handle de contexte et qu’il n’appellera pas les routines d’exécution.

Valeur retournée

Retourne status RPC. RpcServerUnregisterIfEx n’échoue pas, sauf s’il est fourni avec des valeurs non valides.

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

Remarques

La fonction RpcServerUnregisterIfEx attend que tous les appels sur une interface donnée se terminent avant de désinscrire les handles de contexte.

La fonction RpcServerUnregisterIfEx fournit toutes les fonctionnalités fournies dans la fonction RpcServerUnregisterIf . En outre, la fonction RpcServerUnregisterIfEx annule l’inscription de tous les handles de contexte inscrits par l’interface donnée. L’interface doit utiliser l’attribut strict_context_handle , sinon les résultats ne sont pas définis.

RpcServerUnregisterIfEx est la seule fonction qui fournit un déchargement sécurisé d’une DLL avec des handles de contexte actifs en dehors de l’arrêt du processus. Il est disponible sur Windows XP et les versions ultérieures de Windows uniquement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll