Поделиться через

Функция FwpmEngineGetOption0 (fwpmk.h)

  • Статья

Функция FwpmEngineGetOption0 получает параметр обработчика фильтров.

Синтаксис

NTSTATUS FwpmEngineGetOption0(
  [in]  HANDLE             engineHandle,
  [in]  FWPM_ENGINE_OPTION option,
  [out] FWP_VALUE0         **value
);

Параметры

[in] engineHandle

Обработка открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0, чтобы открыть сеанс в обработчике фильтров.

[in] option

Извлекаемая возможность.

[out] value

Значение параметра. Тип данных, содержащийся в параметре значения, будет FWP_UINT32.

Если параметр FWPM_ENGINE_COLLECT_NET_EVENTS, значение будет одним из следующих значений.

Ценность Значение
0 Сетевые события не собираются.
1 Собираются сетевые события.

Если параметр FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS, значение будет побитовой комбинацией следующих значений.

Ценность Значение
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST (1) Собираются события сети многоадресной рассылки.
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST (2) Исходящие трансляции сетевых событий не собираются.

Если параметр FWPM_ENGINE_PACKET_QUEUING (доступен только в Windows 8 и Windows Server 2012), значение будет одним из следующих значений.

Ценность Значение
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE (0) Очередь пакетов не включена.
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND (1) Включена очередь входящих пакетов.
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND (2) Включена очередь исходящих пакетов.

Если параметр FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (доступен только в Windows 8 и Windows Server 2012), значение будет одним из следующих.

Ценность Значение
0 Функция мониторинга подключений IPsec отключена. События подключения или уведомления IPsec не регистрируются.
1 Включена функция мониторинга подключений IPsec. Регистрируются новые события подключения и уведомления IPsec.

Если параметр FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (доступен только в Windows 8 и Windows Server 2012), значение будет время в миллисекундах, указывающее максимальную длительность для одной транзакции МПП. Транзакции, принимающие больше времени, активируют событие watchdog.

Параметр FWPM_ENGINE_NAME_CACHE зарезервирован для внутреннего использования.

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

Возврат кода или значения Описание
ERROR_SUCCESS 0 Параметр был успешно получен.
0x80320001 кода ошибки FWP_E_* — 0x80320039 Конкретная ошибка платформы фильтрации Windows (МПП). Дополнительные сведения см. в кодов ошибок МПП.
код ошибки RPC_* 0x80010001 — 0x80010122 Не удаляйте связь с подсистемой удаленного или локального брандмауэра.
другие коды NTSTATUS Произошла ошибка.

Замечания

Вызывающий объект должен освободить возвращенный объект путем вызова FwpmFreeMemory0.

Вызывающий объект должен FWPM_ACTRL_READ доступ к обработчику фильтров. Дополнительные сведения см. в управления доступом.

FwpmEngineGetOption0 является конкретной реализацией FwpmEngineGetOption. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows Vista.
целевая платформа Всеобщий
заголовка fwpmk.h
библиотеки fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

См. также