다음을 통해 공유

FwpmProviderContextEnum3 함수(fwpmu.h)

  • 아티클

공급자 컨텍스트 열거자에서 결과의 다음 페이지를 반환합니다.

구문

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***entries,
  UINT32                 *numEntriesReturned
);

매개 변수

engineHandle

형식: _In_ HANDLE

필터 엔진을 사용하여 열린 세션에 대한 핸들입니다. 필터 엔진을 사용하여 세션을 열려면 FwpmEngineOpen0을 호출합니다.

enumHandle

형식: _In_ HANDLE

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

numEntriesRequested

형식: _In_ UINT32

요청된 공급자 컨텍스트 개체의 수입니다.

entries

형식: _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

반환된 공급자 컨텍스트 개체입니다.

numEntriesReturned

형식: _Out_ UINT32*

반환된 공급자 컨텍스트 개체의 수입니다.

반환 값

형식: DWORD*

반환 코드/값 설명
ERROR_SUCCESS
0		 공급자 컨텍스트가 성공적으로 열거되었습니다.
FWP_E_* 오류 코드
0x80320001 — 0x80320039		 WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요.
RPC_* 오류 코드
0x80010001 — 0x80010122		 원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다.

설명

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

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

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

FwpmProviderContextEnum3은 열거형 핸들을 만들 때 수행된 공급자 컨텍스트의 스냅샷 작동합니다.

요구 사항

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