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

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

  • Статья

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

Синтаксис

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

Параметры

[in] engineHandle

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

[in] enumHandle

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

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

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

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

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

Замечания

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

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

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

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

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

Требования

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

См. также