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

  • Статья

Функция IkeextSaEnum2 возвращает следующую страницу результатов перечисления сопоставления безопасности IKE/AuthIP (SA).

Синтаксис

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

Параметры

[in] engineHandle

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

[in] enumHandle

Дескриптор перечисления IKE/AuthIP SA. Вызовите IkeextSaCreateEnumHandle0, чтобы получить дескриптор перечисления.

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

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

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

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

Замечания

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

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

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

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

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

Требования

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

См. также