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

Функция FwpmSessionCreateEnumHandle0 (fwpmu.h)

  • Статья

Функция FwpmSessionCreateEnumHandle0 создает дескриптор, используемый для перечисления набора объектов сеанса.

Синтаксис

DWORD FwpmSessionCreateEnumHandle0(
  [in]           HANDLE                            engineHandle,
  [in, optional] const FWPM_SESSION_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                            *enumHandle
);

Параметры

[in] engineHandle

Тип: HANDLE

Дескриптор открытого сеанса для подсистемы фильтрации. Вызовите FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in, optional] enumTemplate

Тип: FWPM_SESSION_ENUM_TEMPLATE0*

Шаблон для выборочного ограничения перечисления.

[out] enumHandle

Тип: HANDLE*

Дескриптор для перечисления фильтра.

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

Тип: DWORD

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

Комментарии

Если enumTemplate имеет значение NULL, возвращаются все объекты сеанса.

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

Невозможно вызвать FwpmSessionCreateEnumHandle0 из транзакции. При FWP_E_TXN_IN_PROGRESS произойдет сбой. Дополнительные сведения о транзакциях см. в разделе Управление объектами.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll

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

FWPM_SESSION_ENUM_TEMPLATE0

FwpmSessionDe присоздатьEnumHandle0