다음을 통해 공유

FwpmConnectionCreateEnumHandle0 함수(fwpmk.h)

  • 아티클

FwpmConnectionCreateEnumHandle0 함수는 연결 개체 집합을 열거하는 데 사용되는 핸들을 만듭니다.

통사론

NTSTATUS FwpmConnectionCreateEnumHandle0(
  [in]           HANDLE                               engineHandle,
  [in, optional] const FWPM_CONNECTION_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                               *enumHandle
);

매개 변수

[in] engineHandle

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

[in, optional] enumTemplate

열거형을 선택적으로 제한하기 위한 템플릿입니다.

[out] enumHandle

HANDLE 변수의 주소입니다. 함수 반환에는 열거형에 대한 핸들이 포함됩니다.

반환 값

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

발언

enumTemplate NULL경우 모든 연결 개체가 반환됩니다.

호출자는 FwpmConnectionDestroyEnumHandle0호출하여 반환된 핸들을 해제해야 합니다.

호출자는 연결 개체의 컨테이너에 FWPM_ACTRL_ENUM 액세스하고 연결 개체에 대한 액세스를 FWPM_ACTRL_READ 합니다. 자세한 내용은 Access Control 참조하세요.

요구 사항

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

참고 항목