FwpsAcquireWritableLayerDataPointer0-Funktion (fwpsk.h)

Artikel
02/07/2025

Die FwpsAcquireWritableLayerDataPointer0-Funktion gibt layerspezifische Daten zurück, die überprüft und geändert werden können.

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

Syntax

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

Parameter

[in] classifyHandle

Ein Handle für die Klassifizierungsanforderung. Dieses Handle wird durch Aufrufen abgerufen. FwpsAcquireClassifyHandle0.

[in] filterId

Der Wert des FilterId Member des klassifizierenFnFilterparameters der Funktion. Weitere Informationen zum element FilterId finden Sie unter FWPS_FILTER1.

[in] flags

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

[out] writableLayerData

Ein Datenpuffer, der die modifizierbaren Daten für die Ebene enthält. Die unterstützten Datentypen, die im folgenden Abschnitt "Hinweise" aufgeführt sind, werden als Strukturen definiert. Bei Rückgabe können auf die Daten zugegriffen werden, indem der leere Zeiger in den entsprechenden Strukturtyp umgeformt wird.

[in, out] classifyOut

Legen Sie den klassifizierenOut Parameter der klassifizierenFn-Funktion des Popuptreibers fest. Der klassifizierenOut- Parameter von klassifizierenFn wird als Ausgabeparameter im Header aufgeführt, enthält jedoch genügend Informationen zur Eingabe, die für das Modul nützlich sind, wenn er an FwpsAcquireWritableLayerDataPointer0übergeben wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Rückruffunktion wurde erfolgreich registriert.
Andere Statuscodes	Fehler.

Bemerkungen

FwpsAcquireWritableLayerDataPointer0 legt die folgenden Member der FWPS_CLASSIFY_OUT0-Struktur fest:

klassifizierenOut->actionType- = FWP_ACTION_BLOCK
klassifizierenOut-->Rechte &= ~FWPS_RIGHT_ACTION_WRITE

Für jeden Aufruf dieser Funktion müssen Sie einen übereinstimmenden Aufruf an FwpsApplyModifiedLayerData0 vornehmen, um die vorgenommenen Änderungen abzuschließen, auch wenn Ihr Popuptreiber keine Daten geändert hat. Wenn Sie den Aufruf von FwpsApplyModifiedLayerData0nicht ausführen, kann dies dazu führen, dass die Klassifizierung nicht ordnungsgemäß abgeschlossen wird.

Die folgenden Strukturen sind definiert, um modifizierbare Layerdaten zu enthalten. Der für die Ausgabe festgelegte Zeiger als writableLayerData--Parameter kann in einen der folgenden Typen umgeschrieben werden:

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