NPI_PROVIDER_DETACH_CLIENT_FN Rückruffunktion (netioddk.h)
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 beim Anfügen an das Clientmodul auf den NMR zurück.
Rückgabewert
Die ProviderDetachClient- Rückruffunktion eines Anbietermoduls gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Das Anbietermodul wurde erfolgreich vom Clientmodul getrennt. |
|
Das Anbietermodul konnte nicht sofort vom Clientmodul getrennt werden. |
Bemerkungen
Die NMR ruft die ProviderDetachClient Rückruffunktion eines Anbietermoduls auf, wenn die Bindung zwischen dem Anbietermodul und einem Clientmodul 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 ProviderDetachClient- Rückruffunktion aufgerufen wurde, sollte ein Anbietermodul keine weiteren Aufrufe an die NPI- Rückruffunktionen des Clientmoduls vornehmen. Wenn keine laufenden Aufrufe an die NPI-Rückruffunktionen des Clientmoduls vorhanden sind, wenn die ProviderDetachClient- Rückruffunktion des Anbietermoduls aufgerufen wird, gibt die ProviderDetachClient- Rückruffunktion des Anbietermoduls STATUS_SUCCESS zurück.
Wenn laufende Aufrufe an eine oder mehrere der NPI-Funktionen des Clientmoduls ausgeführt werden, wenn die ProviderDetachClient- Rückruffunktion des Anbietermoduls aufgerufen wird, gibt die ProviderDetachClient- Rückruffunktion des Anbietermoduls STATUS_PENDING zurück. In diesem Fall muss das Anbietermodul die NmrProviderDetachClientComplete Funktion, nachdem alle laufenden Aufrufe der NPI-Rückruffunktionen des Clientmoduls abgeschlossen wurden. Der Aufruf an den NmrProviderDetachClientComplete Funktion benachrichtigt die NMR, dass die Trennung vom Clientmodul 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 zwischeneinander abgeschlossen haben.
Die NMR ruft die ProviderDetachClient- Rückruffunktion eines Anbietermoduls 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 |