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

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

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

 

Синтаксис

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

Параметры

[in] engineHandle

Тип: HANDLE

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

[in] enumHandle

Тип: HANDLE

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

[in] numEntriesRequested

Тип: UINT32

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

[out] entries

Тип: FWPM_NET_EVENT0***

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

[out] numEntriesReturned

Тип: UINT32*

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

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

Тип: DWORD

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

Комментарии

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

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

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

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

Требования

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

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

FWPM_NET_EVENT0

FwpmNetEventCreateEnumHandle0

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