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

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

Возвращает следующую страницу результатов из перечислителя контекста поставщика.

Синтаксис

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***entries,
  UINT32                 *numEntriesReturned
);

Параметры

engineHandle

Тип: _In_ HANDLE

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

enumHandle

Тип: _In_ HANDLE

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

numEntriesRequested

Тип: _In_ UINT32

Количество запрошенных объектов контекста поставщика.

entries

Тип: _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

Возвращенные объекты контекста поставщика.

numEntriesReturned

Тип: _Out_ UINT32*

Количество возвращаемых объектов контекста поставщика.

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

Тип: DWORD*

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

Комментарии

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

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

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

FwpmProviderContextEnum3 работает с snapshot контекстов поставщика, принятых во время создания дескриптора перечисления.

Требования

Требование Значение
Заголовок fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll
  • Last updated on