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

  • Статья

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

Примечание. IPsecSaContextEnum0 — это конкретная реализация IPsecSaContextEnum, используемая в Windows Vista. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows . Для Windows 7 и более поздних версий доступен IPsecSaContextEnum1 .
 

Синтаксис

DWORD IPsecSaContextEnum0(
  [in]  HANDLE            engineHandle,
  [in]  HANDLE            enumHandle,
  [in]  UINT32            numEntriesRequested,
  [out] IPSEC_SA_CONTEXT0 ***entries,
  [out] UINT32            *numEntriesReturned
);

Параметры

[in] engineHandle

Тип: HANDLE

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

[in] enumHandle

Тип: HANDLE

Дескриптор перечисления контекста SA, возвращаемого IPsecSaContextCreateEnumHandle0.

[in] numEntriesRequested

Тип: UINT32

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

[out] entries

Тип: IPSEC_SA_CONTEXT0***

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

[out] numEntriesReturned

Тип: UINT32*

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

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

Тип: DWORD

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

Комментарии

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

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

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll

См. также раздел

IPSEC_SA_CONTEXT0

IPsecSaContextCreateEnumHandle0