структура 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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	fwpmtypes.h