다음을 통해 공유

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*

반환된 열거형 항목의 수입니다.

반환 값

반환 코드/값 설명
ERROR_SUCCESS
0		 네트워크 이벤트가 성공적으로 열거되었습니다.
FWP_E_NET_EVENTS_DISABLED
0x80320013		 네트워크 진단 이벤트의 컬렉션을 사용할 수 없습니다.
FwpmEngineSetOption0을 호출하여 사용하도록 설정합니다.
FWP_E_* 오류 코드
0x80320001— 0x80320039		 WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요.
RPC_* 오류 코드
0x80010001— 0x80010122		 원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다.

설명

numEntriesReturned이 numEntriesRequested보다 작으면 열거형이 소진됩니다.

FwpmFreeMemory0을 호출하여 반환된 항목 배열(개별 항목 자체는 해제하지 않음)을 해제해야 합니다.

동일한 enumHandle 매개 변수를 사용하는 후속 호출은 현재 항목 버퍼에 있는 이벤트 다음에 다음 이벤트 집합을 반환 합니다 .

FwpmNetEventEnum4 는 enumHandle 매개 변수를 만들기 전에 기록된 이벤트만 반환합니다. 자세한 내용은 로깅을 참조하세요.

요구 사항

요구 사항 값
헤더 fwpmu.h
라이브러리 Fwpuclnt.lib
DLL Fwpuclnt.dll