Freigeben über


FwpsAcquireWritableLayerDataPointer0-Funktion (fwpsk.h)

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

Weitere Informationen

FWPS_BIND_REQUEST0

FWPS_CLASSIFY_OUT0

FWPS_CONNECT_REQUEST0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsApplyModifiedLayerData0

FwpsReleaseClassifyHandle0

klassifizierenFn