FWPM_PROVIDER_CONTEXT2 구조체(fwpmtypes.h)
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 구조가 필요합니다.
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
형식이 FWPM_IPSEC_IKE_QM_TRANSPORT_CONTEXT 때 사용할 수 있습니다.
ikeQmTunnelPolicy
형식: IPSEC_TUNNEL_POLICY2*
형식이 FWPM_IPSEC_IKE_QM_TUNNEL_CONTEXT 때 사용할 수 있습니다.
authipQmTransportPolicy
[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_OPTIONS_CONTEXT 때 사용할 수 있습니다.
ikeV2QmTunnelPolicy
형식: IPSEC_TUNNEL_POLICY2*
형식이 FWPM_IPSEC_IKEV2_QM_TUNNEL_CONTEXT 때 사용할 수 있습니다.
ikeV2QmTransportPolicy
형식이 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 |