共用方式為

FwpmNetEventEnum4 函式 (fwpmu.h)

  • 發行項

從網路事件列舉值擷取下一頁的結果。

語法

DWORD FwpmNetEventEnum4(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT4 ***entries,
  UINT32          *numEntriesReturned
);

參數

engineHandle

類型：_In_ HANDLE

使用篩選引擎開啟之會話的句柄。 若要使用篩選引擎開啟會話，請呼叫 FwpmEngineOpen0。

enumHandle

類型：_In_ HANDLE

呼叫 FwpmNetEventCreateEnumHandle0 所建立的網路事件列舉句柄。

numEntriesRequested

類型：_In_ UINT32

要求的列舉項目數目。

entries

類型：_Outptr_result_buffer_ (*numEntriesReturned) const FWPM_NET_EVENT4***

列舉項目的位址。

numEntriesReturned

類型：_Out_ UINT32*

傳回的列舉項目數目。

傳回值

傳回碼/值 Description
ERROR_SUCCESS
0		 已成功列舉網路事件。
FWP_E_NET_EVENTS_DISABLED
0x80320013		 網路診斷事件的集合已停用。
呼叫 FwpmEngineSetOption0 以啟用它。
FWP_E_* 錯誤碼
0x80320001— 0x80320039		 Windows 篩選平臺 () 特定錯誤。 如需詳細資訊，請參閱 其錯誤碼。
RPC_* 錯誤碼
0x80010001— 0x80010122		 無法與遠端或本機防火牆引擎通訊。

備註

如果 numEntriesReturned 小於 numEntriesRequested，則會耗盡列舉。

您必須呼叫 FwpmFreeMemory0，以釋放傳回的項目陣列 (，但不能釋放個別專案本身) 。

使用相同 enumHandle 參數的後續呼叫會傳回下一組事件，並遵循目前 專案 緩衝區中的事件集。

FwpmNetEventEnum4 只會傳回在 建立 enumHandle 參數之前所記錄的事件。 如需詳細資訊，請參閱 記錄。

規格需求

需求 值
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll