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

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

  • Статья

Функция IPsecSaDbGetSecurityInfo0 извлекает копию дескриптора безопасности для базы данных связи безопасности IPsec (SA).

Синтаксис

NTSTATUS IPsecSaDbGetSecurityInfo0(
  [in]            HANDLE               engineHandle,
  [in]            SECURITY_INFORMATION securityInfo,
  [out, optional] PSID                 *sidOwner,
  [out, optional] PSID                 *sidGroup,
  [out, optional] PACL                 *dacl,
  [out, optional] PACL                 *sacl,
  [out]           PSECURITY_DESCRIPTOR *securityDescriptor
);

Параметры

[in] engineHandle

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

[in] securityInfo

Тип извлекаемой информации безопасности.

[out, optional] sidOwner

Идентификатор безопасности владельца (SID) в возвращаемом дескрипторе безопасности.

[out, optional] sidGroup

Идентификатор безопасности основной группы (SID) в возвращаемом дескрипторе безопасности.

[out, optional] dacl

Список управления доступом (DACL) в возвращаемом дескрипторе безопасности.

[out, optional] sacl

Список управления доступом системы (SACL) в возвращаемом дескрипторе безопасности.

[out] securityDescriptor

Дескриптор возвращаемой безопасности.

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

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

Замечания

Возвращаемый параметр securityDescriptor должен быть освобожден через вызов FwpmFreeMemory0. Остальные четыре возвращаемые параметры не должны быть освобождены, так как они указывают на адреса в параметре securityDescriptor.

Эта функция работает как стандартная функция Win32 GetSecurityInfo. Вызывающий объект должен иметь те же стандартные права доступа, что и в справочной статье GetSecurityInfo.

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

Требования

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

См. также