NmrDeregisterClient-Funktion (netioddk.h)

Artikel
02/26/2024

Die NmrDeregisterClient-Funktion hebt die Registrierung eines Clientmoduls aus dem NMR auf.

Syntax

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

Parameter

[in] NmrClientHandle

Ein Handle, das vom NMR verwendet wird, um die Registrierung des Clientmoduls darzustellen. Der NMR gibt dieses Handle an das Clientmodul zurück, wenn das Clientmodul die NmrRegisterClient-Funktion aufruft.

Rückgabewert

Die NmrDeregisterClient-Funktion gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_PENDING	Der NMR initiierte die Aufhebung der Registrierung des Clientmoduls. Das Clientmodul muss die Die NmrWaitForClientDeregisterComplete-Funktion wartet, bis die Registrierung abgeschlossen ist, bevor das Clientmodul entladen werden kann.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Wenn ein Clientmodul die NmrDeregisterClient-Funktion aufruft, ruft der NMR die ClientDetachProvider-Rückruffunktion des Clientmoduls und die ProviderDetachClient-Rückruffunktion des Anbietermoduls für jede der Bindungen zwischen dem Clientmodul und einem Anbietermodul auf. Die Registrierung des Clientmoduls aus dem NMR ist abgeschlossen, nachdem sich das Clientmodul erfolgreich von allen Anbietermodulen getrennt hat, an die es angefügt ist, und alle diese Anbietermodule erfolgreich vom Clientmodul getrennt haben.

Ein Clientmodul ruft in der Regel die NmrDeregisterClient-Funktion aus seiner Unload-Funktion auf, um sich von allen Anbietermodulen zu trennen, an die es angefügt ist, bevor das Clientmodul aus dem System entladen wird. Nach dem Aufrufen der NmrDeregisterClient-Funktion muss ein Clientmodul die Die NmrWaitForClientDeregisterComplete-Funktion wartet, bis die Registrierung abgeschlossen ist, bevor das Clientmodul entladen werden kann. Ein Clientmodul darf erst nach Abschluss der Deregistrierung von einem Aufruf der Unload-Funktion zurückgegeben werden.

Hinweis Wenn ein Clientmodul das Windows-Treiberframework verwendet, ruft es in der Regel die NmrDeregisterClient-Funktion aus seiner EvtDriverUnload-Ereignisrückruffunktion auf. In dieser Situation darf das Clientmodul erst nach Abschluss der Deregistrierung von einem Aufruf seiner EvtDriverUnload-Funktion zurückkehren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	netioddk.h (einschließen von Wsk.h)
Bibliothek	Netio.lib
IRQL	<= DISPATCH_LEVEL