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

Статья
06/27/2024

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

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

Синтаксис

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

Параметры

[in] engineHandle

Тип: HANDLE

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

[in] enumHandle

Тип: HANDLE

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

[in] numEntriesRequested

Тип: UINT32

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

[out] entries

Тип: FWPM_NET_EVENT1***

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

[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, вернет следующий набор событий после этих событий в текущем записях буфере.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 R2 [только классические приложения]
целевая платформа	Виндоус
заголовка	fwpmu.h
библиотеки	Fwpuclnt.lib
DLL	Fwpuclnt.dll

См. также

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

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

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