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

  • Статья

В структуре FWPM_CALLOUT0 хранится состояние, связанное с выноской.

Синтаксис

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

Члены

calloutKey

Однозначно идентифицирует сеанс.

Если идентификатор GUID инициализирован равным нулю в вызове FwpmCalloutAdd0, базовый механизм фильтрации (BFE) создаст его.

displayData

Структура FWPM_DISPLAY_DATA0 , содержащая доступные для чтения заметки, связанные с выноской. Элемент имениструктуры FWPM_DISPLAY_DATA0 является обязательным.

flags

Значение Значение
FWPM_CALLOUT_FLAG_PERSISTENT
 Выноска сохраняется при перезагрузках. В результате на него можно ссылаться во время загрузки и другие постоянные фильтры.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT
 Выноске требуется доступ к контексту поставщика, хранящейся в фильтре, вызывающем выноску. Если этот флаг установлен, контекст поставщика будет скопирован из структуры [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) в структуру FWPS_FILTER0 . Структура FWPS_FILTER0 задокументирована в WDK.
FWPM_CALLOUT_FLAG_REGISTERED
 В настоящее время выноска зарегистрирована в ядре. Этот флаг нельзя задавать при добавлении новых выносок. Он используется только при запросе состояния существующих выносок.

providerKey

Уникально идентифицирует поставщика, связанного с выноской. Если элемент не равен NULL, будут возвращены только объекты, связанные с указанным поставщиком.

providerData

Структура FWP_BYTE_BLOB , содержащая необязательные данные, относящиеся к поставщику, которая позволяет поставщикам хранить дополнительные сведения контекста в объекте .

applicableLayer

Указывает слой, в котором можно использовать выноску. Только фильтры на этом уровне могут вызывать выноску. Дополнительные сведения см. в разделе Фильтрация идентификаторов слоев.

calloutId

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

Комментарии

Первые шесть элементов этой структуры содержат данные, предоставляемые при добавлении объектов.

Последний элемент, calloutId, предоставляет дополнительные сведения, возвращаемые при получении или перечислении объектов.

FWPM_CALLOUT0 — это конкретная реализация FWPM_CALLOUT. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Требования

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

См. также раздел

Структуры API платформы фильтрации Windows