FwpsAcquireWritableLayerDataPointer0-Funktion (fwpsk.h)
Die Funktion FwpsAcquireWritableLayerDataPointer0 gibt ebenenspezifische Daten zurück, die überprüft und geändert werden können.
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 |
|---|---|
|
Die Rückruffunktion wurde erfolgreich registriert. |
|
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 |