NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN Rückruffunktion (netioddk.h)
Die ProviderCleanupBindingContext Rückruffunktion eines Anbietermoduls führt alle erforderlichen Bereinigungs- und Deallocations des Bindungskontexts des Anbietermoduls aus, nachdem sich das Anbietermodul und ein Clientmodul voneinander getrennt haben.
Syntax
NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;
void NpiProviderCleanupBindingContextFn(
[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 wurde. Die ProviderAttachClient- Rückruffunktion des Anbietermoduls gibt diesen Zeiger beim Anfügen an das Clientmodul auf den NMR zurück.
Rückgabewert
Nichts
Bemerkungen
Die NMR ruft die ProviderCleanupBindingContext Rückruffunktion eines Anbietermoduls auf, nachdem sich der Anbieter und ein Clientmodul voneinander getrennt haben.
Die ProviderCleanupBindingContext- Rückruffunktion eines Anbietermoduls sollte alle erforderlichen Bereinigungen der Daten ausführen, die in der Bindungskontextstruktur des Anbietermoduls enthalten sind. Anschließend sollte der Speicher für die Bindungskontextstruktur freigegeben werden, wenn das Anbietermodul den Speicher für die Struktur dynamisch zugeordnet hat.
Wenn das Anbietermodul den Speicher für den Bindungskontext nicht dynamisch zuweist und keine andere Bereinigung des Bindungskontexts erforderlich ist, muss das Anbietermodul keine ProviderCleanupBindingContext- Rückruffunktion implementieren. Wenn das Anbietermodul keine ProviderCleanupBindingContext- Rückruffunktion implementiert, muss es den ProviderCleanupBindingContext Member des Elements festlegen. NPI_PROVIDER_CHARACTERISTICS Struktur, um NULL-zu, wenn sie die NmrRegisterProvider--Funktion aufruft, um sich bei nmR zu registrieren.
Die NMR ruft die ProviderCleanupBindingContext 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 |