Функция FwpsClassifyOptionSet0 (fwpsk.h)

Статья
08/07/2023

Функция FwpsClassifyOptionSet0 вызывается функцией classifyFn фильтра выносок для указания дополнительных сведений, влияющих на характеристики разрешенных операций фильтрации.

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

Синтаксис

NTSTATUS FwpsClassifyOptionSet0(
  [in] const FWPS_INCOMING_METADATA_VALUES0 *inMetadataValues,
  [in] const FWP_CLASSIFY_OPTION_TYPE       option,
  [in] const FWP_VALUE0                     *newValue
);

Параметры

[in] inMetadataValues

Указатель на структуру FWPS_INCOMING_METADATA_VALUES0 . Эта структура содержит значения для каждого поля метаданных на фильтруемом слое.

[in] option

Константа перечисления FWP_CLASSIFY_OPTION_TYPE , указывающая, относится ли параметр newValue к состояниям одноадресной рассылки, многоадресной рассылки или слабой исходной связи, а также к значениям времени ожидания данных. Дополнительные сведения см. в подразделе "Примечания".

[in] newValue

Указатель на массив FWP_VALUE0 структур. Каждая структура в массиве содержит определенные значения для определенной константы FWP_OPTION_VALUE_XXX. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

Функция FwpsClassifyOptionSet0 возвращает один из следующих кодов NTSTATUS.

Код возврата	Описание
STATUS_SUCCESS	Функция успешно завершена.
STATUS_FWP_INVALID_ENUMERATOR	Параметр параметра не соответствует ни одному из значений в перечисление FWP_CLASSIFY_OPTION_TYPE .
STATUS_FWP_OUT_OF_BOUNDS	Значение параметра, заданное параметром newValue -> uint32 , не включает одно из определенных значений FWP_OPTION_VALUE_XXX констант.
STATUS_OBJECT_TYPE_MISMATCH	Тип данных, указанный параметром newValue -> Type , не был FWP_UINT32.
STATUS_UNSUCCESSFUL	Произошла общая ошибка.
Другие коды состояния	Произошла ошибка.

Параметр Параметр	newValue->тип Value	newValue->значение uint32
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE Включите слабое сопоставление источников. FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE Отключите слабое сопоставление источников.
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE Разрешить создание состояния многоадресной рассылки локального канала для исходящего трафика. FWP_OPTION_VALUE_DENY_MULTICAST_STATE Не разрешайте создание состояния многоадресной рассылки локального канала для исходящего трафика. FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE Разрешить создание состояния многоадресной рассылки для исходящего трафика (разрешение ответов, не относящихся к локальному каналу).
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	Указывает время существования состояния многоадресной и широковещательной рассылки в секундах.
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	Указывает время существования состояния одноадресной рассылки в секундах.

Первый (самый высокий вес) вызывающий объект, задал определенный параметр, будет предоставлен этот параметр. Например, если выноска A задает параметр состояния многоадресной рассылки, выноска B не сможет это сделать, но выноска B может задать другие параметры.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows Vista.
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL