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 |