FwpsAcquireWritableLayerDataPointer0-Funktion (fwpsk.h)

Artikel
02/29/2024

Die Funktion FwpsAcquireWritableLayerDataPointer0 gibt ebenenspezifische 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 Zielgruppenspezifische Windows-Versionen .

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 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.

[out] writableLayerData

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

[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 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 status Codes	Ein Fehler ist aufgetreten.

Hinweise

FwpsAcquireWritableLayerDataPointer0 legt die folgenden Member der FWPS_CLASSIFY_OUT0-Struktur fest:

klassifizierenOut->Actiontype = FWP_ACTION_BLOCK
klassifizierenOut->rights &= ~FWPS_RIGHT_ACTION_WRITE

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

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

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