ISecurityInformation：：GetSecurity 方法 (aclui.h)

项目
02/23/2024

GetSecurity 方法请求正在编辑其安全描述符的安全对象的安全描述符。访问控制编辑器调用此方法以检索对象的当前或默认安全描述符。

语法

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

参数

[in] RequestedInformation

一组 SECURITY_INFORMATION 位标志，指示所请求的安全描述符的各个部分。此参数可以是以下值的组合。

值	含义
OWNER_SECURITY_INFORMATION	安全描述符必须包含对象所有者的 SID。
GROUP_SECURITY_INFORMATION	安全描述符必须包含对象的主组的 SID。
DACL_SECURITY_INFORMATION	安全描述符必须包含对象的 DACL。
SACL_SECURITY_INFORMATION	安全描述符必须包含对象的 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