AtlSetSacl

调用此函数将指定对象中的系统访问控制列表(acl) (SACL)信息。

重要

此功能无法在 Windows 运行时执行的应用程序。

inline bool AtlSetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CSacl& rSacl,
DWORD dwInheritanceFlowControl= 0,
bool bRequestNeededPrivileges= true
) throw(...);

参数

  • hObject
    对对象的句柄能够设置安全信息。

  • ObjectType
    指定从指示 hObject 参数标识的对象的类型的 SE_OBJECT_TYPE 枚举的值。

  • rSacl
    包含新的安全信息的SACL。

  • dwInheritanceFlowControl
    继承流控制。 此值可为0 (默认值),PROTECTED_SACL_SECURITY_INFORMATION或UNPROTECTED_SACL_SECURITY_INFORMATION。

  • bRequestNeededPrivileges
    如果为true,则函数将尝试启用SE_SECURITY_NAME权限,然后恢复它在完成。

返回值

如果成功,则返回 true;如果失败,则返回 false。

备注

在调试版本中,断言将发生错误,则 hObject 无效,或者,如果 dwInheritanceFlowControl 不是三个允许的值之一。

如果 AtlSetSacl 将调用许多不同的对象中多次,将会更加高效在调用函数之前一次启用SE_SECURITY_NAME权限,同时 bRequestNeededPrivileges 设置为false。

要求

Header: atlsecurity.h

请参见

参考

AtlGetSacl

CSacl选件类

其他资源

安全全局函数