다음을 통해 공유


FwpmConnectionEnum0 함수(fwpmk.h)

FwpmConnectionEnum0 함수는 연결 개체 열거자에서 결과의 다음 페이지를 반환합니다.

통사론

NTSTATUS FwpmConnectionEnum0(
  [in]  HANDLE           engineHandle,
  [in]  HANDLE           enumHandle,
  [in]  UINT32           numEntriesRequested,
  [out] FWPM_CONNECTION0 ***entries,
  [out] UINT32           *numEntriesReturned
);

매개 변수

[in] engineHandle

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

[in] enumHandle

FwpmConnectionCreateEnumHandle0호출하여 만든 공급자 컨텍스트 열거형에 대한 핸들입니다.

[in] numEntriesRequested

요청된 연결 개체의 수입니다.

[out] entries

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

[out] numEntriesReturned

매개 변수를 항목에 반환된 항목 수입니다.

반환 값

반환 코드/값 묘사
ERROR_SUCCESS
0
연결 개체가 성공적으로 열거되었습니다.
FWP_E_* 오류 코드
0x80320001 — 0x80320039
WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드 참조하세요.
RPC_* 오류 코드
0x80010001 — 0x80010122
원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다.
다른 NTSTATUS 코드 오류가 발생했습니다.

발언

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

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

동일한 열거형 핸들을 사용하는 후속 호출은 마지막 출력 버퍼에 있는 항목 다음에 다음 항목 집합을 반환합니다.

FwpmConnectionEnum0 열거형 핸들을 만들 때 만든 연결 개체의 스냅샷에서 작동합니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼 보편적
헤더 fwpmk.h
라이브러리 fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

참고 항목