FwpsAcquireClassifyHandle0-Funktion (fwpsk.h)

Die Funktion FwpsAcquireClassifyHandle0 generiert einen Klassifizierungshandle, der 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 Für bestimmte Versionen von Windows .
 

Syntax

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

Parameter

[in] classifyContext

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

[in] flags

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

[out] classifyHandle

Ein Zeiger auf eine Variable, die einen Klassifizierungshandpunkt empfängt. Dieser Handle wird durch nachfolgende Funktionsaufrufe benötigt, wie in den Anmerkungen angegeben.

Rückgabewert

Die Funktion FwpsAcquireClassifyHandle0 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 Parameter "klassifizierenHandle " verweist, enthält den Handle für die Klassifizierungsanforderung.
Andere Statuscodes
Ein Fehler ist aufgetreten.

Hinweise

FwpsAcquireClassifyHandle0 ist eine Unterstützungsfunktion für asynchrone Klassifizierung und Datenänderung. Der 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

   
Unterstützte Mindestversion (Client) Ab Windows 7 verfügbar.
Zielplattform Universell
Header fwpsk.h (include Fwpsk.h)
Bibliothek Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

klassifizierenFn

klassifizierenFn1