NPI_CLIENT_DETACH_PROVIDER_FN Rückruffunktion (netioddk.h)
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 er den NmrClientAttachProvider Funktion aufruft, die an das Anbietermodul angefügt werden soll.
Rückgabewert
Die ClientDetachProvider- Rückruffunktion eines Clientmoduls gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Das Clientmodul wurde erfolgreich vom Anbietermodul getrennt. |
|
Das Clientmodul konnte nicht sofort vom Anbietermodul getrennt werden. |
Bemerkungen
Die NMR ruft die ClientDetachProvider Rückruffunktion eines Clientmoduls auf, wenn die Bindung zwischen dem Clientmodul und einem Anbietermodul beendet werden muss. Das Trennen 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 an die NPI--Funktionen des Anbietermoduls vornehmen. Wenn keine laufenden Aufrufe an die NPI-Funktionen des Anbietermoduls vorhanden sind, wenn die ClientDetachProvider- Rückruffunktion aufgerufen wird, gibt die ClientDetachProvider- Rückruffunktion des Clientmoduls STATUS_SUCCESS zurück.
Wenn laufende Aufrufe an eine oder mehrere der NPI- funktionen des Anbietermoduls ausgeführt werden, wenn die ClientDetachProvider- Rückruffunktion des Clientmoduls aufgerufen wird, 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 an den NmrClientDetachProviderComplete Funktion benachrichtigt nmR, dass die Trennung vom Anbietermodul abgeschlossen ist.
Die NMR ruft die Clientmoduls auf ClientCleanupBindingContext Rückruffunktion und des Anbietermoduls ProviderCleanupBindingContext Rückruffunktion, nachdem sowohl das Clientmodul als auch das Anbietermodul die Trennung voneinander abgeschlossen haben.
Die NMR ruft die ClientDetachProvider Rückruffunktion eines Clientmoduls bei jeder IRQL-<= DISPATCH_LEVEL auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Fenster |
| Header- | netioddk.h (include Wsk.h) |
| IRQL- | <= DISPATCH_LEVEL |