AtlGetSacl

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

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

inline bool AtlGetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CSacl* pSacl,
bool bRequestNeededPrivileges= true
) throw(...);

参数

• hObject
  为检索安全信息的对象的句柄。

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

• pSacl
  对于将包含检索的安全信息的SACL对象的指针。

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

返回值

如果成功，则返回 true；如果失败，则返回 false。

备注

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

要求

Header: atlsecurity.h

请参见

参考

AtlSetSacl

CSacl选件类

其他资源

安全全局函数