다음을 통해 공유

FWPM_FILTER_ENUM_TEMPLATE0 구조체(fwpmtypes.h)

  • 아티클

FWPM_FILTER_ENUM_TEMPLATE0 구조체는 필터를 열거하는 데 사용됩니다.

구문

typedef struct FWPM_FILTER_ENUM_TEMPLATE0_ {
  GUID                                 *providerKey;
  GUID                                 layerKey;
  FWP_FILTER_ENUM_TYPE                 enumType;
  UINT32                               flags;
  FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 *providerContextTemplate;
  UINT32                               numFilterConditions;
  FWPM_FILTER_CONDITION0               *filterCondition;
  UINT32                               actionMask;
  GUID                                 *calloutKey;
} FWPM_FILTER_ENUM_TEMPLATE0;

멤버

providerKey

이 필터와 연결된 공급자를 고유하게 식별합니다.

layerKey

필드를 열거할 레이어입니다.

enumType

필터 조건이 해석되는 방법을 결정하는 FWP_FILTER_ENUM_TYPE 값입니다.

flags

값 의미
FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH
 가중치가 가장 높은 종료 필터만 반환합니다.
FWP_FILTER_ENUM_FLAG_SORTED
 가중치별로 정렬된 일치하는 모든 필터를 반환합니다(가장 높음에서 가장 낮음).
FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY
 부팅 시간 필터만 반환합니다.
FWP_FILTER_ENUM_FLAG_INCLUDE_BOOTTIME
 부팅 시간 필터 포함; FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY 플래그가 설정된 경우 무시됩니다.
FWP_FILTER_ENUM_FLAG_INCLUDE_DISABLED
 사용하지 않도록 설정된 필터 포함; FWP_FILTER_ENUM_FLAG_BOOTTIME_ONLY 플래그가 설정된 경우 무시됩니다.
FWP_FILTER_ENUM_VALID_FLAGS
 FWP_FILTER_ENUM_FLAG_BEST_TERMINATING_MATCH 및 FWP_FILTER_ENUM_FLAG_SORTED 조합.

providerContextTemplate

열거된 필터 수를 제한하는 데 사용되는 FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 구조체입니다. NULL이 아닌 경우 공급자 컨텍스트가 템플릿과 일치하는 필터만 열거합니다.

numFilterConditions

필터 조건의 수입니다. 0이면 모든 필터가 일치합니다.

filterCondition

고유한 필터 조건을 포함하는 FWPM_FILTER_CONDITION0 구조체의 배열입니다(중복된 필터 조건은 오류를 생성합니다).

actionMask

actionMask에 하나 이상의 비트가 포함된 작업 형식의 필터만 반환됩니다. FWP_ACTION_ 상수를 직접 사용하는 것은 여러 비트가 포함되어 있으므로 의도한 대로 작동하지 않을 수 있습니다. 몇 가지 일반적인 예는 아래 표에 있습니다(^ 논리 XOR 연산자를 나타낸다).

값 의미
FWP_ACTION_BLOCK ^ FWP_ACTION_FLAG_TERMINATING
 **FWP_ACTION_BLOCK** 작업이 있는 필터를 열거합니다.
FWP_ACTION_PERMIT ^ FWP_ACTION_FLAG_TERMINATING
 **FWP_ACTION_PERMIT** 작업이 있는 필터를 열거합니다.
**FWP_ACTION_FLAG_CALLOUT**
 설명선 드라이버를 참조하는 필터를 열거합니다.
**참고** **calloutKey**는 **NULL**이 아니어야 합니다.
 
0xFFFFFFFF
 열거할 때 필터의 작업 유형을 무시합니다.

calloutKey

콜아웃을 고유하게 식별합니다.

설명

FWPM_FILTER_ENUM_TEMPLATE0 FWPM_FILTER_ENUM_TEMPLATE 특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 fwpmtypes.h

추가 정보

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0

FWP_FILTER_ENUM_TYPE

Windows 필터링 플랫폼 API 구조