AtlGetSecurityDescriptor

调用此函数检索特定对象的安全说明符。

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

inline bool AtlGetSecurityDescriptor(
LPCTSTR pszObjectName,
SE_OBJECT_TYPE ObjectType,
CSecurityDesc * pSecurityDescriptor,
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION | 
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges= true
) throw(...);

参数

• pszObjectName
  为指定对象的名称检索安全信息的一个Null结尾的字符串的指针。

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

• pSecurityDescriptor
  接收请求的安全说明符的对象。

• requestedInfo
  设置 SECURITY_INFORMATION 指示安全信息的类型检索的位标志。此参数可以是下列值的组合。

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

返回值

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

备注

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

要求

Header: atlsecurity.h

请参见

其他资源

安全全局函数