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

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

  • Статья

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

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

Синтаксис

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

Параметры

[in] engineHandle

Тип: HANDLE

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

[in] enumHandle

Тип: HANDLE

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

[in] numEntriesRequested

Тип: UINT32

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

[out] entries

Тип: IPSEC_SA_CONTEXT1***

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

[out] numEntriesReturned

Тип: UINT32*

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

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

Тип: DWORD

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

Комментарии

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

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

Требования

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

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

IPSEC_SA_CONTEXT1

IPsecSaContextCreateEnumHandle0