NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN Rückruffunktion (netioddk.h)

Die ProviderCleanupBindingContext-Rückruffunktion eines Anbietermoduls führt alle erforderlichen Bereinigungen und Zuordnungen des Bindungskontexts des Anbietermoduls durch, 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 auf den NMR zurück, wenn er an das Clientmodul angefügt wird.

Rückgabewert

Keine

Bemerkungen

Der 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 Arbeitsspeicher für die Bindungskontextstruktur freigegeben werden, wenn das Anbietermodul den Arbeitsspeicher für die Struktur dynamisch zugeordnet hat.

Wenn das Anbietermodul den Speicher für seinen Bindungskontext nicht dynamisch zuordnet 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 das ProviderCleanupBindingContext-Element des NPI_PROVIDER_CHARACTERISTICS Struktur auf NULL , wenn die NmrRegisterProvider-Funktion aufgerufen wird, um sich selbst beim NMR zu registrieren.

Der NMR ruft die ProviderCleanupBindingContext-Rückruffunktion eines Anbietermoduls bei jedem 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 (include Wsk.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient