FwpsCalloutUnregisterByKey0-Funktion (fwpsk.h)

Artikel
03/01/2024

Die Funktion FwpsCalloutUnregisterByKey0 hebt die Registrierung einer Legende aus der Filter-Engine auf.

HinweisFwpsCalloutUnregisterByKey0 ist eine bestimmte Version von FwpsCalloutUnregisterByKey. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen .

Syntax

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Parameter

[in] calloutKey

Ein Zeiger auf eine GUID, die die Legende eindeutig identifiziert, die von der Filter-Engine nicht registriert wird. Dies muss ein Zeiger auf dieselbe GUID sein, die angegeben wurde, als der Legendentreiber entweder die Funktionen FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufgerufen hat, um die Legende bei der Filter-Engine zu registrieren.

Rückgabewert

Die FwpsCalloutUnregisterByKey0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Legende wurde erfolgreich von der Filter-Engine registriert.
STATUS_DEVICE_BUSY	Es gibt mindestens einen Datenfluss, der von der Legende verarbeitet wird und die einen hervorragenden Kontext aufweisen, der dem Datenfluss zugeordnet ist. Ein Legendentreiber muss die FwpsFlowRemoveContext0-Funktion für jeden dieser Datenflüsse aufrufen, um den zugeordneten Kontext zu entfernen. Nachdem der Kontext erfolgreich aus jedem dieser Datenflüsse entfernt wurde, muss der Legendentreiber die Funktion FwpsCalloutUnregisterByKey0 erneut aufrufen, um die Registrierung der Legende aus der Filter-Engine zu beenden.
STATUS_FWP_CALLOUT_NOT_FOUND	Bei der Filter-Engine ist keine Legende registriert, die der GUID entspricht, die im parameter calloutKey angegeben ist.
STATUS_FWP_IN_USE	Die Legende wird bereits in einem anderen Thread registriert oder aufgehoben.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber ruft die Funktion FwpsCalloutUnregisterByKey0 auf, um die Registrierung einer Legende aus der Filter-Engine aufzuheben, wobei der GUID-Schlüssel verwendet wird, um die Legende zu identifizieren, die nicht registriert werden soll. Diese Funktion ist erfolgreich, auch wenn in der Filter-Engine Filter vorhanden sind, die die Beschriftung für die Aktion des Filters angeben. In dieser Situation werden Filter mit einem Aktionstyp von FWP_ACTION_CALLOUT_TERMINATING oder FWP_ACTION_CALLOUT_UNKNOWN als FWP_ACTION_BLOCK behandelt, und Filter mit einem Aktionstyp von FWP_ACTION_CALLOUT_INSPECTION werden ignoriert, nachdem die Legende von der Filter-Engine abgemeldet wurde.

Ein Legendentreiber kann erst entladen werden, wenn alle Legenden, die zuvor beim Filtermodul registriert wurden, die Registrierung erfolgreich aufgehoben wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fwpsk.h (include fwpsk.h)
Bibliothek	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL