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

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

  • Статья

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

Синтаксис

NTSTATUS FwpmNetEventCreateEnumHandle0(
  [in]           HANDLE                              engineHandle,
  [in, optional] const FWPM_NET_EVENT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                              *enumHandle
);

Параметры

[in] engineHandle

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

[in, optional] enumTemplate

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

[out] enumHandle

Дескриптор перечисления сетевых событий.

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

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

Замечания

Если перечислениеTemplateNULL, возвращаются все объекты сетевого события.

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

Эта функция не может вызываться из транзакции, она завершается ошибкой с FWP_E_TXN_IN_PROGRESS. Дополнительные сведения о транзакциях см. в управления объектами.

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

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

Требования

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

См. также