FwpsAcquireClassifyHandle0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsAcquireClassifyHandle0--Funktion generiert ein Klassifizierungshandle, das verwendet wird, um asynchrone Klassifizierungsvorgänge und Anforderungen für schreibbare Layerdaten zu identifizieren.

HinweisFwpsAcquireClassifyHandle0 ist eine bestimmte Version von FwpsAcquireClassifyHandle. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows.

Syntax

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Parameter

[in] classifyContext

Der klassifizierenContext Parameter aus klassifizierenFn1. Das WFP-Modul übergibt diesen Wert an die klassifizierenFndes Popuptreibers.

[in] flags

Reserviert für die zukünftige Verwendung. Auf 0 festgelegt.

[out] classifyHandle

Ein Zeiger auf eine Variable, die ein Klassifizierungshandle empfängt. Dieses Handle wird von nachfolgenden Funktionsaufrufen benötigt, wie in den Anmerkungen erwähnt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Ein Handle für die Klassifizierungsanforderung wurde erfolgreich zurückgegeben. Die Variable, auf die die klassifizierenHandle Parameter verweist, um das Handle für die Klassifizierungsanforderung zu enthalten.
Andere Statuscodes	Fehler.

Bemerkungen

FwpsAcquireClassifyHandle0 ist eine Unterstützungsfunktion für asynchrone Klassifizierung und Datenänderung. Das von dieser Funktion zurückgegebene Handle ist als Parameter für die folgenden Funktionen erforderlich:

Für jeden Aufruf dieser Funktion muss der Popuptreiber FwpsReleaseClassifyHandle0- aufrufen, um die dem Handle zugeordneten Systemressourcen freizugeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 7.
Zielplattform-	Universal
Header-	fwpsk.h (include Fwpsk.h)
Library	Fwpkclnt.lib
IRQL-	<= DISPATCH_LEVEL

Siehe auch

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

klassifizierenFn-

klassifizierenFn1

Freigeben über