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 |