共用方式為

fwpmNetEventEnum5 函式 (fwpmu.h)

  • 發行項

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

語法

DWORD FwpmNetEventEnum5(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT5 ***entries,
  UINT32          *numEntriesReturned
);

參數

engineHandle

類型：_In_ HANDLE

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

enumHandle

類型：_In_ HANDLE

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

numEntriesRequested

類型：_In_ UINT32

要求的列舉項目數目。

entries

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

列舉項目的位址。

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 參數的呼叫會傳回下一組事件，並遵循目前 專案 緩衝區中的事件。

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

規格需求

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