FwpmNetEventEnum1 함수(fwpmu.h)

FwpmNetEventEnum1 함수는 네트워크 이벤트 열거자에서 결과의 다음 페이지를 반환합니다.

참고FwpmNetEventEnum1 Windows 7 이상에서 사용되는 FwpmNetEventEnum의 특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정을 참조하세요. Windows 8의 경우 FwpmNetEventEnum2 사용할 수 있습니다. Windows Vista의 경우 FwpmNetEventEnum0 사용할 수 있습니다.

 

통사론

DWORD FwpmNetEventEnum1(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT1 ***entries,
  [out] UINT32          *numEntriesReturned
);

매개 변수

[in] engineHandle

형식: HANDLE

필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0 호출하여 필터 엔진에 대한 세션을 엽니다.

[in] enumHandle

형식: HANDLE

FwpmNetEventCreateEnumHandle0호출하여 만든 네트워크 이벤트 열거형에 대한 핸들입니다.

[in] numEntriesRequested

형식: UINT32

요청된 열거형 항목의 수입니다.

[out] entries

형식: FWPM_NET_EVENT1***

열거형 항목의 주소입니다.

[out] numEntriesReturned

형식: UINT32*

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

반환 값

형식: DWORD

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

발언

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

반환된 항목 배열(개별 항목 자체는 아님)은 FwpmFreeMemory0호출하여 해제해야 합니다.

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

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	fwpmu.h
라이브러리	Fwpuclnt.lib
DLL	Fwpuclnt.dll

참고 항목

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

WFP 로깅