FWPM_PROVIDER_CONTEXT1 구조체(fwpmtypes.h)

아티클
08/23/2023

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

구문

typedef struct FWPM_PROVIDER_CONTEXT1_ {
  GUID                       providerContextKey;
  FWPM_DISPLAY_DATA0         displayData;
  UINT32                     flags;
  GUID                       *providerKey;
  FWP_BYTE_BLOB              providerData;
  FWPM_PROVIDER_CONTEXT_TYPE type;
  union {
    IPSEC_KEYING_POLICY0    *keyingPolicy;
    IPSEC_TRANSPORT_POLICY1 *ikeQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY1 *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY1    *authipQmTunnelPolicy;
    IKEEXT_POLICY1          *ikeMmPolicy;
    IKEEXT_POLICY1          *authIpMmPolicy;
    FWP_BYTE_BLOB           *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0  *classifyOptions;
    IPSEC_TUNNEL_POLICY1    *ikeV2QmTunnelPolicy;
    IKEEXT_POLICY1          *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0     *idpOptions;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT1;

멤버

providerContextKey

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

displayData

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

flags

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

공급자 컨텍스트 플래그	의미
FWPM_PROVIDER_CONTEXT_FLAG_PERSISTENT	개체는 영구적입니다. 즉, BFE 중지/시작에서 유지됩니다.

providerKey

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

providerData

공급자가 개체와 함께 추가 컨텍스트 정보를 저장할 수 있도록 하는 선택적 공급자별 데이터를 포함하는 FWP_BYTE_BLOB 구조체입니다.

type

공급자 컨텍스트의 형식을 지정하는 FWPM_PROVIDER_CONTEXT_TYPE 값입니다.

keyingPolicy

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

자세한 내용은 IPSEC_KEYING_POLICY0 참조하세요.

ikeQmTransportPolicy

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

자세한 내용은 IPSEC_TRANSPORT_POLICY1 참조하세요.

ikeQmTunnelPolicy

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

자세한 내용은 IPSEC_TUNNEL_POLICY1 참조하세요.

authipQmTransportPolicy

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

자세한 내용은 IPSEC_TRANSPORT_POLICY1 참조하세요.

authipQmTunnelPolicy

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

자세한 내용은 IPSEC_TUNNEL_POLICY1 참조하세요.

ikeMmPolicy

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

자세한 내용은 IKEEXT_POLICY1 참조하세요.

authIpMmPolicy

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

자세한 내용은 IKEEXT_POLICY1 참조하세요.

dataBuffer

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

자세한 내용은 FWP_BYTE_BLOB 참조하세요.

classifyOptions

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

자세한 내용은 FWPM_CLASSIFY_OPTIONS0 참조하세요.

ikeV2QmTunnelPolicy

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

자세한 내용은 IPSEC_TUNNEL_POLICY1 참조하세요.

ikeV2MmPolicy

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

자세한 내용은 IKEEXT_POLICY1 참조하세요.

idpOptions

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

자세한 내용은 IPSEC_DOSP_OPTIONS0 참조하세요.

providerContextId

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

설명

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

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

요구 사항

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