ISecurityInformation：：GetSecurity 方法 (aclui.h)
GetSecurity 方法请求正在编辑其安全描述符的安全对象的安全描述符。 访问控制编辑器调用此方法以检索对象的当前或默认安全描述符。
语法
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
参数
[in] RequestedInformation
一组 SECURITY_INFORMATION 位标志，指示所请求的安全描述符的各个部分。 此参数可以是以下值的组合。
| 值 | 含义 |
|---|---|
|
安全描述符必须包含对象所有者的 SID。 |
|
安全描述符必须包含对象的主组的 SID。 |
|
安全描述符必须包含对象的 DACL。 |
|
安全描述符必须包含对象的 SACL。 |
[out] ppSecurityDescriptor
指向变量的指针，实现必须设置为指向对象安全描述符的指针。 安全描述符必须包含 RequestedInformation 参数请求的组件。
系统调用 LocalFree 函数以释放返回的指针。
[in] fDefault
如果此参数为 TRUE， 则 ppSecurityDescriptor 应返回对象的应用程序定义的默认安全描述符。 访问控制编辑器使用此默认安全描述符重新初始化属性页。
仅当用户单击“默认”按钮时，访问控制编辑器才会将此参数设置为 TRUE。 仅当在 ISecurityInformation：：GetObjectInformation 方法中设置SI_RESET标志时，才会显示“默认”按钮。 如果没有可用的默认安全描述符，请不要设置SI_RESET标志。
如果此标志为 FALSE， 则 ppSecurityDescriptor 应返回对象的当前安全描述符。
返回值
如果成功，则返回S_OK。
如果发生错误，则返回非零错误代码。 如果用户无权读取请求的安全信息，则返回E_ACCESSDENIED。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | aclui.h |