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

Статья
07/16/2024

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

Синтаксис

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

Параметры

[in] engineHandle

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

[in] enumHandle

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

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

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

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

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

Замечания

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

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

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

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

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

Требования

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

См. также

Ниже приведены все отформатированные ссылки markdown в текущем документе:

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