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

Статья
07/16/2024

Функция IPsecDospStateEnum 0 возвращает следующую страницу результатов из перечислителя состояния защиты IPsec DoS.

Синтаксис

NTSTATUS IPsecDospStateEnum0(
  [in]  HANDLE            engineHandle,
  [in]  HANDLE            enumHandle,
  [in]  UINT32            numEntriesRequested,
  [out] IPSEC_DOSP_STATE0 ***entries,
  [out] UINT32            *numEntries
);

Параметры

[in] engineHandle

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

[in] enumHandle

Обработка перечисления IPsec DoS Protection. Вызовите IPsecDospStateCreateEnumHandle0 для получения дескриптора перечисления.

[in] numEntriesRequested

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

[out] entries

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

[out] numEntries

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

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

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

Замечания

Каждая запись состояния защиты doS IPsec соответствует потоку, успешно прошедшему проверку подлинности IPsec DoS Protection.

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

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

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

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

Требования

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

См. также

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

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