FwpsAcquireWritableLayerDataPointer0 函式 (fwpsk.h)

發行項
02/29/2024

FwpsAcquireWritableLayerDataPointer0 函式會傳回可檢查和變更的圖層特定數據。

注意FwpsAcquireWritableLayerDataPointer0 是特定版本的 FwpsAcquireWritableLayerDataPointer。如需詳細資訊，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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

參數

[in] classifyHandle

分類要求的句柄。呼叫來取得此句柄 FwpsAcquireClassifyHandle0。

[in] filterId

classifyFn 函式篩選參數之 FilterId 成員的值。如需 FilterId 成員的詳細資訊，請參閱 FWPS_FILTER1。

[in] flags

保留供未來使用。設定為零。

[out] writableLayerData

包含層次可修改數據的數據緩衝區。下列一節中列出的支持數據類型會定義為結構。傳回時，可以將 void 指標轉換成適當的結構類型來存取數據。

[in, out] classifyOut

設定為圖說文字驅動程式的 classifyFn 函式的 classifyOut 參數。 classifyFn 的 classifyOut 參數會列為標頭中的輸出參數，但它包含足夠的輸入資訊，以在傳遞至 FwpsAcquireWritableLayerDataPointer0 時對引擎很有用。

傳回值

FwpsAcquireWritableLayerDataPointer0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	已成功註冊回呼函式。
其他狀態代碼	發生錯誤。

備註

FwpsAcquireWritableLayerDataPointer0 會設定 FWPS_CLASSIFY_OUT0 結構的下列成員：

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->rights &= ~FWPS_RIGHT_ACTION_WRITE

對於此函式的每個呼叫，您必須對 FwpsApplyModifiedLayerData0 進行相符呼叫，才能完成所做的變更，即使您的圖說文字驅動程式未修改任何數據也一樣。如果您未呼叫 FwpsApplyModifiedLayerData0，可能會導致分類未正確完成。

下列結構定義為包含可修改的圖層數據。輸出上設定為 writableLayerData 參數的指標可以轉換成下列其中一種類型：

規格需求

需求	值
最低支援的用戶端	從 Windows 7 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL