NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN Rückruffunktion (netioddk.h)

Die ClientCleanupBindingContext-Rückruffunktion eines Clientmoduls führt alle erforderlichen Bereinigungen und Deallocations des Bindungskontexts des Clientmoduls durch, nachdem sich das Clientmodul und ein Anbietermodul voneinander getrennt haben.

Syntax

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [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 sich getrennt hat. Das Clientmodul übergibt diesen Zeiger an den NMR, wenn es die NmrClientAttachProvider-Funktion aufruft, um das Anbietermodul anzufügen.

Rückgabewert

Keine

Bemerkungen

Der NMR ruft die ClientCleanupBindingContext-Rückruffunktion eines Clientmoduls auf, nachdem sich das Clientmodul und ein Anbietermodul voneinander getrennt haben.

Die ClientCleanupBindingContext-Rückruffunktion eines Clientmoduls sollte alle erforderlichen Bereinigungen der Daten durchführen, die in der Bindungskontextstruktur des Clientmoduls enthalten sind. Anschließend sollte der Arbeitsspeicher für die Bindungskontextstruktur freigegeben werden, wenn das Clientmodul den Arbeitsspeicher dynamisch für die Struktur zugewiesen hat.

Wenn das Clientmodul den Arbeitsspeicher für seinen Bindungskontext nicht dynamisch ordnet und keine andere Bereinigung des Bindungskontexts erforderlich ist, muss das Clientmodul keine ClientCleanupBindingContext-Rückruffunktion implementieren. Wenn das Clientmodul keine ClientCleanupBindingContext-Rückruffunktion implementiert, muss das ClientCleanupBindingContext-Element des NPI_CLIENT_CHARACTERISTICS Struktur auf NULL , wenn die NmrRegisterClient-Funktion aufgerufen wird, um sich beim NMR zu registrieren.

Der NMR ruft die ClientCleanupBindingContext-Rückruffunktion eines Clientmoduls 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

Weitere Informationen

ClientAttachProvider

ClientDetachProvider

NPI_CLIENT_CHARACTERISTICS

NmrClientAttachProvider

ProviderDetachClient