NPI_CLIENT_DETACH_PROVIDER_FN Rückruffunktion (netioddk.h)

Artikel
02/26/2024

Die ClientDetachProvider-Rückruffunktion eines Clientmoduls trennt das Clientmodul von einem Anbietermodul.

Syntax

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

NTSTATUS NpiClientDetachProviderFn(
  [in] PVOID ClientBindingContext
)
{...}

Parameter

[in] ClientBindingContext

Ein Zeiger auf den Kontext des Clientmoduls für die Bindung zwischen dem Clientmodul und dem Anbietermodul, von dem es getrennt wird. Das Clientmodul übergibt diesen Zeiger an den NMR, wenn es die NmrClientAttachProvider-Funktion aufruft, um sie an das Anbietermodul anzufügen.

Rückgabewert

Die ClientDetachProvider-Rückruffunktion eines Clientmoduls gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Das Clientmodul wurde erfolgreich vom Anbietermodul getrennt.
STATUS_PENDING	Das Clientmodul konnte nicht sofort vom Anbietermodul getrennt werden.

Hinweise

Der NMR ruft die ClientDetachProvider-Rückruffunktion eines Clientmoduls auf, wenn die Bindung zwischen dem Clientmodul und einem Anbietermodul beendet werden muss. Die Trennung wird entweder durch das Clientmodul initiiert, das die NmrDeregisterClient-Funktion aufruft, oder das Anbietermodul, das die NmrDeregisterProvider-Funktion aufruft.

Nachdem die ClientDetachProvider-Rückruffunktion aufgerufen wurde, sollte ein Clientmodul keine weiteren Aufrufe der NPI-Funktionen des Anbietermoduls ausführen. Wenn beim Aufrufen der ClientDetachProvider-Rückruffunktion des Clientmoduls keine laufenden Aufrufe der NPI-Funktionen des Anbietermoduls vorhanden sind, gibt die ClientDetachProvider-Rückruffunktion des Clientmoduls STATUS_SUCCESS zurück.

Wenn beim Aufruf der ClientDetachProvider-Rückruffunktion des Clientmoduls beim Aufrufen der ClientDetachProvider-Rückruffunktion des Clientmoduls eine oder mehrere NPI-Funktionen des Anbietermoduls ausgeführt werden, gibt die ClientDetachProvider-Rückruffunktion des Clientmoduls STATUS_PENDING zurück. In diesem Fall muss das Clientmodul die NmrClientDetachProviderComplete-Funktion , nachdem alle laufenden Aufrufe der NPI-Funktionen des Anbietermoduls abgeschlossen wurden. Der Aufruf von Die NmrClientDetachProviderComplete-Funktion benachrichtigt den NMR, dass die Trennung vom Anbietermodul abgeschlossen ist.

Der NMR ruft die des Clientmoduls auf. ClientCleanupBindingContext-Rückruffunktion und die des Anbietermoduls ProviderCleanupBindingContext-Rückruffunktion , nachdem sowohl das Clientmodul als auch das Anbietermodul die Trennung voneinander abgeschlossen haben.

Der NMR ruft die ClientDetachProvider-Rückruffunktion eines Clientmoduls bei jedem IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Windows
Kopfzeile	netioddk.h (include Wsk.h)
IRQL	<= DISPATCH_LEVEL