FwpmFilterGetById0 函式 (fwpmu.h)
FwpmFilterGetById0函式會擷取篩選物件。
語法
DWORD FwpmFilterGetById0(
[in] HANDLE engineHandle,
[in] UINT64 id,
[out] FWPM_FILTER0 **filter
);
參數
[in] engineHandle
類型： HANDLE
篩選引擎開啟會話的控制碼。 呼叫 FwpmEngineOpen0 以開啟篩選引擎的會話。
[in] id
類型： UINT64
所需物件的執行時間識別碼。 當應用程式為此物件呼叫 FwpmFilterAdd0 時，會從系統接收此識別碼。
[out] filter
類型： FWPM_FILTER0**
篩選條件資訊。
傳回值
類型： DWORD
| 傳回碼/值 | 描述 |
|---|---|
|
已成功擷取篩選。 |
|
Windows 篩選平台 () 特定錯誤。 如需詳細資訊，請參閱 其錯誤碼 。 |
|
無法與遠端或本機防火牆引擎通訊。 |
備註
呼叫端必須透過 呼叫 FwpmFreeMemory0釋放傳回的物件。
呼叫端需要 FWPM_ACTRL_READ 篩選的存取權。 如需詳細資訊，請參閱存取控制。
FwpmFilterGetById0 是 FwpmFilterGetById 的特定實作。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | fwpmu.h |
| 程式庫 | Fwpuclnt.lib |
| Dll | Fwpuclnt.dll |