FWPM_PROVIDER_CONTEXT2 구조체(fwpmtypes.h)

아티클
08/23/2023

FWPM_PROVIDER_CONTEXT2 구조체는 공급자 컨텍스트와 연결된 상태를 저장합니다. FWPM_PROVIDER_CONTEXT0 사용할 수 있습니다.

구문

typedef struct FWPM_PROVIDER_CONTEXT2_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY1    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY2    *authipQmTunnelPolicy;
    IKEEXT_POLICY2          *ikeMmPolicy;
    IKEEXT_POLICY2          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY2    *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2 *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT2;

멤버

providerContextKey

형식: GUID

공급자 컨텍스트를 고유하게 식별합니다. FwpmProviderContextAdd2 호출에서 GUID가 0으로 초기화되면 BFE(기본 필터링 엔진)가 생성됩니다.

displayData

형식: FWPM_DISPLAY_DATA0

공급자 컨텍스트에 사람이 읽을 수 있는 형식으로 주석을 추가할 수 있습니다. FWPM_DISPLAY_DATA0 구조가 필요합니다.

flags

형식: UINT32

가능한 값은 다음과 같습니다.

공급자 컨텍스트 플래그	의미
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	개체는 영구적입니다. 즉, BFE 중지/시작에서 유지됩니다.
FWPM_PROVIDER_CONTEXT_FLAG_DOWNLEVEL	내부용으로 예약된 속성입니다.

providerKey

형식: GUID*

이 개체를 관리하는 정책 공급자의 GUID입니다.

providerData

형식: FWP_BYTE_BLOB

공급자가 개체를 사용하여 추가 컨텍스트 정보를 저장할 수 있도록 하는 선택적 공급자별 데이터입니다.

type

형식: FWPM_PROVIDER_CONTEXT_TYPE

공급자 컨텍스트의 형식입니다.

keyingPolicy

형식: IPSEC_KEYING_POLICY1*

형식이 FWPM_IPSEC_KEYING_CONTEXT 때 사용할 수 있습니다.

ikeQmTransportPolicy

형식: IPSEC_TRANSPORT_POLICY2*

형식이 FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT 때 사용할 수 있습니다.

ikeQmTunnelPolicy

형식: IPSEC_TUNNEL_POLICY2*

형식이 FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT 때 사용할 수 있습니다.

authipQmTransportPolicy

형식: IPSEC_TRANSPORT_POLICY2*

[case()] [unique]

authipQmTunnelPolicy

형식: IPSEC_TUNNEL_POLICY2*

형식이 FWPM_IPSEC_AUTHIP_QM_TRANSPORT_CONTEXT 때 사용할 수 있습니다.

ikeMmPolicy

형식: IKEEXT_POLICY2*

형식이 FWPM_IPSEC_IKE_MM_CONTEXT 때 사용할 수 있습니다.

authIpMmPolicy

형식: IKEEXT_POLICY2*

형식이 FWPM_IPSEC_AUTHIP_MM_CONTEXT 때 사용할 수 있습니다.

dataBuffer

형식: FWP_BYTE_BLOB*

형식이 FWPM_GENERAL_CONTEXT 때 사용할 수 있습니다.

classifyOptions

형식: FWPM_CLASSIFY_OPTIONS0*

형식이 FWPM_CLASSIFY_OPTIONS_CONTEXT 때 사용할 수 있습니다.

ikeV2QmTunnelPolicy

형식: IPSEC_TUNNEL_POLICY2*

형식이 FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT 때 사용할 수 있습니다.

ikeV2QmTransportPolicy

형식: IPSEC_TRANSPORT_POLICY2*

형식이 FWPM_IPSEC_IKEV2_QM_TRANSPORT_CONTEXT 때 사용할 수 있습니다.

ikeV2MmPolicy

형식: IKEEXT_POLICY2*

형식이 FWPM_IPSEC_IKEV2_MM_CONTEXT 때 사용할 수 있습니다.

idpOptions

형식: IPSEC_DOSP_OPTIONS0*

형식이 FWPM_IPSEC_DOSP_CONTEXT 때 사용할 수 있습니다.

providerContextId

형식: UINT64

컨텍스트를 식별하는 LUID입니다. 공급자 컨텍스트를 참조하는 필터의 FWPS_FILTER1 구조에 저장된 컨텍스트 값입니다. FWPS_FILTER1 구조체는 WDK에 설명되어 있습니다.

설명

공용 구조체의 처음 7개 요소는 개체를 추가할 때 제공되는 정보입니다.

마지막 요소는 개체를 가져오고 열거할 때 반환되는 추가 정보입니다.

요구 사항

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