NmrDeregisterClient-Funktion (netioddk.h)

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:

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.

Anforderungen

Weitere Informationen

ClientDetachProvider

EvtDriverUnload

NmrRegisterClient

ProviderDetachClient

Entladen