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

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

  • Статья

Функция FwpmNetEventEnum 2 возвращает следующую страницу результатов из перечислителя сетевых событий.

Синтаксис

NTSTATUS FwpmNetEventEnum2(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT2 ***entries,
  [out] UINT32          *numEntriesReturned
);

Параметры

[in] engineHandle

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

[in] enumHandle

Обработка перечисления сетевых событий, созданного вызовом FwpmNetEventCreateEnumHandle0.

[in] numEntriesRequested

Количество запрошенных записей перечисления.

[out] entries

Адреса записей перечисления.

[out] numEntriesReturned

Число возвращаемых записей перечисления.

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

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

Замечания

Если numEntriesReturned меньше numEntriesRequested, перечисление исчерпано.

Возвращаемый массив записей (но не отдельные записи) должен быть освобожден вызовом FwpmFreeMemory0.

Последующий вызов, использующий тот же параметр enumHandle, возвращает следующий набор событий после этих событий в текущем записях буфере.

FwpmNetEventEnum2 возвращает только события, зарегистрированные до создания параметра enumHandle. Дополнительные сведения см. в ведения журнала.

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

Требования

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

См. также