Метод ISecurityInformation4::GetSecondarySecurity (aclui.h)
Метод GetSecondarySecurity возвращает дополнительные контексты безопасности, которые могут повлиять на доступ к ресурсу.
Синтаксис
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
Параметры
[out] pSecurityObjects
Массив SECURITY_OBJECT структур, содержащих вторичные объекты безопасности, связанные с ресурсами, заданными при успешном выполнении. Массив принадлежит вызывающей объекту и освобождается с помощью функции LocalFree . Член pwszName также освобождается с помощью LocalFree. Если элементы cbData или cbData2структуры SECURITY_OBJECT не равны нулю, вызывающий объект должен освободить соответствующие pData или pData2 с помощью LocalFree. Если любой из этих элементов равен нулю, то соответствующие элементы pData и pData2 принадлежат диспетчеру ресурсов и должны оставаться действительными до тех пор, пока функция EditSecurity не вернет.
[out] pSecurityObjectCount
Количество объектов безопасности в параметре pSecurityObjects , заданных при успешном выполнении.
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK.
Если происходит сбой метода, он возвращает код ошибки. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
Диспетчер ресурсов не должен возвращать вторичные объекты с элементом fWellKnown , равным TRUE , и элементом Id , равным SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY или SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. Объекты безопасности с этими идентификаторами будут предоставляться редактором управления доступом при вызове ComputeEffectivePermissionWithSecondarySecurity.
Интерпретация возвращаемых объектов безопасности привязана к реализации ComputeEffectivePermissionWithSecondarySecurity.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | aclui.h |