安全全局函数

  • 项目

这些函数支持修改 SID 和 ACL 对象。

重要

下表中列出的函数不能在 Windows 运行时执行的应用程序中使用。

名称 描述
AtlGetDacl 调用此函数可检索指定对象的自由访问控制列表 (DACL) 信息。
AtlSetDacl 调用此函数可设置指定对象的自由访问控制列表 (DACL) 信息。
AtlGetGroupSid 调用此函数可检索对象的组安全标识符 (SID)。
AtlSetGroupSid 调用此函数可设置对象的组安全标识符 (SID)。
AtlGetOwnerSid 调用此函数可检索对象的所有者安全标识符 (SID)。
AtlSetOwnerSid 调用此函数可设置对象的所有者安全标识符 (SID)。
AtlGetSacl 调用此函数可检索指定对象的系统访问控制列表 (SACL) 信息。
AtlSetSacl 调用此函数可设置指定对象的系统访问控制列表 (SACL) 信息。
AtlGetSecurityDescriptor 调用此函数可检索给定对象的安全说明符。

要求

标头： atlsecurity.h

AtlGetDacl

调用此函数可检索指定对象的自由访问控制列表 (DACL) 信息。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlGetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CDacl* pDacl) throw();

参数

hObject
要从中检索安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

pDacl
指向将包含检索的安全信息的 DACL 对象的指针。

返回值

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

备注

在调试版本中，如果 hObject 或 pDacl 无效，将发生断言错误。

AtlSetDacl

调用此函数可设置指定对象的自由访问控制列表 (DACL) 信息。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlSetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CDacl& rDacl,
    DWORD dwInheritanceFlowControl = 0) throw(...);

参数

hObject
要为其设置安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

rDacl
包含新安全信息的 DACL。

dwInheritanceFlowControl
继承流控制。 此值可以是 0（默认）、PROTECTED_DACL_SECURITY_INFORMATION 或UNPROTECTED_DACL_SECURITY_INFORMATION。

返回值

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

备注

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

要求

标头： atlsecurity.h

AtlGetGroupSid

调用此函数可检索对象的组安全标识符 (SID)。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlGetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

参数

hObject
要从中检索安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

pSid
指向将包含新安全信息的 CSid 对象的指针。

返回值

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

要求

标头： atlsecurity.h

AtlSetGroupSid

调用此函数可设置对象的组安全标识符 (SID)。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlSetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

参数

hObject
要为其设置安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

rSid
包含新安全信息的 CSid 对象。

返回值

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

要求

标头： atlsecurity.h

AtlGetOwnerSid

调用此函数可检索对象的所有者安全标识符 (SID)。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlGetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

参数

hObject
要从中检索安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

pSid
指向将包含新安全信息的 CSid 对象的指针。

返回值

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

要求

标头： atlsecurity.h

AtlSetOwnerSid

调用此函数可设置对象的所有者安全标识符 (SID)。

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

inline bool AtlSetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

参数

hObject
要为其设置安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

rSid
包含新安全信息的 CSid 对象。

返回值

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

要求

标头： atlsecurity.h

AtlGetSacl

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

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

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

参数

hObject
要从中检索安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

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

bRequestNeededPrivileges
如果为 true，函数将尝试启用 SE_SECURITY_NAME 特权，并在完成时还原它。

返回值

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

注解

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

要求

标头： atlsecurity.h

AtlSetSacl

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

重要

此函数不能用于在 Windows 运行时中执行的应用程序。

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

参数

hObject
要为其设置安全信息的对象的句柄。

ObjectType
指定 SE_OBJECT_TYPE 枚举中的一个值，该值指示 hObject 参数标识的对象的类型。

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，会更高效。

要求

标头： atlsecurity.h

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
指定 SE_OBJECT_TYPE 枚举中的一个值，指示 pszObjectName 参数标识的对象的类型。

pSecurityDescriptor
接收请求的安全描述符的对象。

requestedInfo
一组 SECURITY_INFORMATION 位标志，指示要检索的安全信息的类型。 此参数可以是以下值的组合。

bRequestNeededPrivileges
如果为 true，函数将尝试启用 SE_SECURITY_NAME 特权，并在完成时还原它。

返回值

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

备注

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

要求

标头： atlsecurity.h

另请参阅

函数