структура FWPM_PROVIDER_CONTEXT3 (fwpmtypes.h)

Статья
04/29/2024

Хранит состояние, связанное с контекстом поставщика. доступны FWPM_PROVIDER_CONTEXT0, FWPM_PROVIDER_CONTEXT1 и FWPM_PROVIDER_CONTEXT2 .

Синтаксис

typedef struct FWPM_PROVIDER_CONTEXT3_ {
  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_POLICY3                     *ikeQmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *authipQmTransportPolicy;
    IPSEC_TUNNEL_POLICY3                     *authipQmTunnelPolicy;
    IKEEXT_POLICY2                           *ikeMmPolicy;
    IKEEXT_POLICY2                           *authIpMmPolicy;
    FWP_BYTE_BLOB                            *dataBuffer;
    FWPM_CLASSIFY_OPTIONS0                   *classifyOptions;
    IPSEC_TUNNEL_POLICY3                     *ikeV2QmTunnelPolicy;
    IPSEC_TRANSPORT_POLICY2                  *ikeV2QmTransportPolicy;
    IKEEXT_POLICY2                           *ikeV2MmPolicy;
    IPSEC_DOSP_OPTIONS0                      *idpOptions;
    FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 *networkConnectionPolicy;
  };
  UINT64                     providerContextId;
} FWPM_PROVIDER_CONTEXT3;

Члены

providerContextKey

Тип: GUID

Уникально идентифицирует контекст поставщика. Если GUID инициализирован с нуля в вызове FwpmProviderContextAdd2, то базовый механизм фильтрации (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()] [уникальный]

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.

networkConnectionPolicy

Указатель на структуру FWPM_NETWORK_CONNECTION_POLICY_SETTINGS0 , содержащую количество политик сетевого подключения, и список этих политик в формате.

providerContextId

Тип: UINT64

LUID, определяющий контекст. Это значение контекста, хранящееся в структуре FWPS_FILTER1 для фильтров, ссылающихся на контекст поставщика. Структура FWPS_FILTER1 задокументирована в WDK. Это дополнительные сведения, возвращаемые при получении или перечислении объектов.