FwpmConnectionEnum0 函式 (fwpmu.h)
FwpmConnectionEnum0 函式會從連接物件列舉值傳回下一頁的結果。
語法
DWORD FwpmConnectionEnum0(
[in] HANDLE engineHandle,
[in] HANDLE enumHandle,
[in] UINT32 numEntriesRequested,
[out] FWPM_CONNECTION0 ***entries,
[out] UINT32 *numEntriesReturned
);
參數
[in] engineHandle
類型: HANDLE
篩選引擎開啟會話的句柄。 呼叫 FwpmEngineOpen0 以開啟篩選引擎的會話。
[in] enumHandle
類型: HANDLE
呼叫 FwpmConnectionCreateEnumHandle0 所建立的提供者內容列舉句柄。
[in] numEntriesRequested
類型: UINT32
所要求的連接物件數目。
[out] entries
類型: FWPM_CONNECTION0***
列舉項目的位址。
[out] numEntriesReturned
類型: UINT32*
傳回值
類型: DWORD
傳回碼/值 | Description |
---|---|
|
成功列舉連接物件。 |
|
Windows 篩選平臺 () 特定錯誤。 如需詳細資訊,請參閱 其錯誤碼 。 |
|
無法與遠端或本機防火牆引擎通訊。 |
備註
如果 numEntriesReturned 小於 numEntriesRequested,列舉就會耗盡。
傳回的項目陣列 (,但個別專案本身) 必須由 FwpmFreeMemory0 呼叫釋放。
使用相同列舉句柄的後續呼叫,將會傳回最後一個輸出緩衝區中專案後面的下一組專案。
FwpmConnectionEnum0 適用於建立列舉句柄時所建立的連接物件快照集。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | fwpmu.h |
程式庫 | Fwpuclnt.lib |
Dll | Fwpuclnt.dll |