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 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 |
|---|---|
|
Das Anbietermodul wurde erfolgreich vom Clientmodul getrennt. |
|
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 |