FwpsAcquireClassifyHandle0-Funktion (fwpsk.h)
Die FwpsAcquireClassifyHandle0-Funktion generiert einen Klassifizierungshandle, der verwendet wird, um asynchrone Klassifizierungsvorgänge und Anforderungen für beschreibbare Schichtdaten zu identifizieren.
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 |
|---|---|
|
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. |
|
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 |