NPI_PROVIDER_DETACH_CLIENT_FN Rückruffunktion (netioddk.h)

Artikel
02/29/2024

Die ProviderDetachClient-Rückruffunktion eines Anbietermoduls trennt das Anbietermodul von einem Clientmodul.

Syntax

NPI_PROVIDER_DETACH_CLIENT_FN NpiProviderDetachClientFn;

NTSTATUS NpiProviderDetachClientFn(
  [in] PVOID ProviderBindingContext
)
{...}

Parameter

[in] ProviderBindingContext

Ein Zeiger auf den Kontext des Anbietermoduls für die Bindung zwischen dem Anbietermodul und dem Clientmodul, von dem es getrennt wird. Die ProviderAttachClient-Rückruffunktion des Anbietermoduls gibt diesen Zeiger auf den NMR zurück, wenn er an das Clientmodul angefügt wird.

Rückgabewert

Die ProviderDetachClient-Rückruffunktion eines Anbietermoduls gibt einen der folgenden NTSTATUS-Codes zurück:

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

Hinweise

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

Nachdem die Rückruffunktion ProviderDetachClient aufgerufen wurde, sollte ein Anbietermodul keine NPI-Rückruffunktionen des Clientmoduls mehr aufrufen. Wenn keine der NPI-Rückruffunktionen des Clientmoduls aufgerufen wird, wenn die ProviderDetachClient-Rückruffunktion des Anbietermoduls aufgerufen wird, gibt die ProviderDetachClient-Rückruffunktion des Anbietermoduls STATUS_SUCCESS zurück.

Wenn eine oder mehrere NPI-Rückruffunktionen des Clientmoduls in Bearbeitung sind, wenn die ProviderDetachClient-Rückruffunktion des Anbietermoduls aufgerufen wird, gibt die ProviderDetachClient-Rückruffunktion des Anbietermoduls STATUS_PENDING zurück. In dieser Situation muss das Anbietermodul die NmrProviderDetachClientComplete-Funktion nach Abschluss aller laufenden Aufrufe der NPI-Rückruffunktionen des Clientmoduls. Der Aufruf des Die NmrProviderDetachClientComplete-Funktion benachrichtigt den NMR, dass die Trennung vom Clientmodul 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 ProviderDetachClient-Rückruffunktion eines Anbietermoduls an einem beliebigen 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 (einschließen von Wsk.h)
IRQL	<= DISPATCH_LEVEL