FwpsPendClassify0-Funktion (fwpsk.h)

Artikel
03/01/2024

Die klassifizierungFn-Funktion einer Legende ruft FwpsPendClassify0 auf, um die aktuelle Klassifizierungsanforderung zu erstellen. Nachdem die Anforderung geschrieben wurde, muss der Legendentreiber die Verarbeitung der Klassifizierungsanforderung asynchron abschließen, indem FwpsCompleteClassify0 aufgerufen wird.

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

Syntax

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Parameter

[in] classifyHandle

Das Klassifizierungshandle, das die Verarbeitung des Legendentreibers auf der aktuellen Ebene identifiziert. Dieses Handle wird durch Aufrufen von FwpsAcquireClassifyHandle0.

[in] filterId

Der Wert des FilterId-Members des filterparameters der funktion klassifizierenFn. Weitere Informationen zum FilterId-Member finden Sie unter FWPS_FILTER1.

[in] flags

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

[in, out] classifyOut

Legen Sie den Parameter klassifizierenOut der Funktion klassifizierenFn des Callouttreibers fest. Der klassifizierenOut-Parameter von klassifizierenFn wird als Ausgabeparameter im Header aufgeführt, enthält jedoch genügend Informationen zur Eingabe, um für die Engine nützlich zu sein, wenn er an FwpsPendClassify übergeben wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Klassifizierungsanforderung wurde erfolgreich geschrieben.
STATUS_FWP_CANNOT_PEND	Die Engine lässt keine asynchrone Klassifizierung auf der Ebene zu, von der aus der Aufruf erfolgt ist.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

FwpsPendClassify0 versetzt die Klassifizierung des angegebenen Ereignisses in einen pended-Zustand. Ein Legendentreiber verwendet in der Regel eine Stiftklassifizierung, sodass mehr Verarbeitung außerhalb des Bereichs der KlassifizierungFn-Legendenfunktion erfolgen kann. Der Legendentreiber kann dann das Klassifizierungshandle und alle anderen relevanten Daten über den Hinweis an eine Funktion übergeben, die weniger Auswirkungen auf die Leistung hat als die Treiber-Legendenfunktionen. Wenn die Verarbeitung abgeschlossen ist, muss die Legende FwpsCompleteClassify0 aufrufen, um den Schreibzustand zu entfernen. Zum Zeitpunkt des Aufrufs von FwpsCompleteClassify muss der Legendentreiber eine ausgefüllte FWPS_CLASSIFY_OUT0 Struktur zurückgeben, genau wie bei einer Inlineklassifizierung.

FwpsPendClassify0 erhöht die Verweisanzahl für das Klassifizierungshandle, das im classificationHandle-Parameter übergeben wird. Nachdem der Legendentreiber diese Funktion aufgerufen hat, kann er aufrufen. FwpsReleaseClassifyHandle0 zum Freigeben des lokalen instance. Wenn FwpsCompleteClassify0 aufgerufen wird, wird der Verweis auf das Handle automatisch verringert.

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