Fonction NmrDeregisterClient (netioddk.h)

Article
02/26/2024

La fonction NmrDeregisterClient supprime l’inscription d’un module client à partir de la RMN.

Syntaxe

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

Paramètres

[in] NmrClientHandle

Handle utilisé par la RMN pour représenter l’inscription du module client. La RMN retourne ce handle au module client lorsque le module client appelle la fonction NmrRegisterClient .

Valeur retournée

La fonction NmrDeregisterClient retourne l’un des codes NTSTATUS suivants :

Code de retour	Description
STATUS_PENDING	La RMN a lancé la désinscription du module client. Le module client doit appeler le La fonction NmrWaitForClientDeregisterComplete doit attendre que la désinscription soit terminée avant que le module client puisse être déchargé.
Autres codes status	Une erreur est survenue.

Remarques

Lorsqu’un module client appelle la fonction NmrDeregisterClient , la RMN appelle la fonction de rappel ClientDetachProvider du module client et la fonction de rappel ProviderDetachClient du module fournisseur pour chacune des liaisons entre le module client et un module fournisseur. La désinscription du module client à partir de la RMN est terminée une fois que le module client s’est correctement détaché de tous les modules du fournisseur auxquels il est attaché et que tous ces modules de fournisseur se sont correctement détachés du module client.

Un module client appelle généralement la fonction NmrDeregisterClient à partir de sa fonction Unload pour se détacher de tous les modules du fournisseur auxquels il est attaché avant que le module client ne soit déchargé du système. Après avoir appelé la fonction NmrDeregisterClient , un module client doit appeler le La fonction NmrWaitForClientDeregisterComplete doit attendre que la désinscription se termine avant que le module client puisse être déchargé. Un module client ne doit pas revenir d’un appel à sa fonction Deload tant qu’une fois la désinscription terminée.

Note Si un module client utilise Windows Driver Framework, il appelle généralement la fonction NmrDeregisterClient à partir de sa fonction de rappel d’événement EvtDriverUnload . Dans ce cas, le module client ne doit pas revenir d’un appel à sa fonction EvtDriverUnload tant qu’une fois la désinscription terminée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	netioddk.h (inclure Wsk.h)
Bibliothèque	Netio.lib
IRQL	<= DISPATCH_LEVEL