FwpsAcquireClassifyHandle0-Funktion (fwpsk.h)

Artikel
02/27/2024

Die FwpsAcquireClassifyHandle0-Funktion generiert einen Klassifizierungshandle, der verwendet wird, um asynchrone Klassifizierungsvorgänge und Anforderungen für beschreibbare Schichtdaten zu identifizieren.

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

Syntax

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

Parameter

[in] classifyContext

Der klassifizierenContext-Parameter aus klassifizierenFn1. Die WFP-Engine übergibt diesen Wert an die KlassifikationFn des Legendentreibers.

[in] flags

Für die zukünftige Verwendung reserviert. Auf 0 festlegen.

[out] classifyHandle

Ein Zeiger auf eine Variable, die ein Klassifizierungshandle empfängt. Dieses Handle wird für nachfolgende Funktionsaufrufe benötigt, wie unter Hinweise beschrieben.

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 der klassifizierungHandle-Parameter verweist, enthält das Handle für die Klassifizierungsanforderung.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

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 Legendentreiber FwpsReleaseClassifyHandle0 aufrufen, um die systemressourcen freizugeben, die dem Handle zugeordnet sind.

Anforderungen

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