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

请参见

其他资源

安全全局函数