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

  • Статья

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

ПримечаниеFwpmNetEventEnum2 — это конкретная реализация FwpmNetEventEnum, используемая в Windows 8 и более поздних версий. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows . Для Windows 7 доступен FwpmNetEventEnum1 . Для Windows Vista доступен FwpmNetEventEnum0 .
 

Синтаксис

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

Параметры

[in] engineHandle

Тип: HANDLE

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

[in] enumHandle

Тип: HANDLE

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

[in] numEntriesRequested

Тип: UINT32

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

[out] entries

Тип: FWPM_NET_EVENT2***

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

[out] numEntriesReturned

Тип: UINT32*

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

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

Тип: DWORD

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

Комментарии

Если аргумент numEntriesReturned меньше numEntriesRequested, перечисление будет исчерпано.

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

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

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

Требования

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

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

FWPM_NET_EVENT2

FwpmNetEventCreateEnumHandle0

Ведение журнала ВПП