CSecurityDesc::ToString

转换安全说明符转换为字符串格式。

bool ToString(
   CString * pstr,
   SECURITY_INFORMATION si = OWNER_SECURITY_INFORMATION | 
      GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION | 
      SACL_SECURITY_INFORMATION 
) const throw(...);

参数

  • pstr
    要接收 字符串格式安全说明符的一个Null结尾的字符串的指针。

  • si
    在输出字符串指定SECURITY_INFORMATION位标志的组合指示安全说明符的元素中。

返回值

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

备注

click-once安全说明符以字符串格式,可以更加轻松地将其存储或传输。使用 CSecurityDesc::FromString 方法将字符串返回安全说明符。

si 参数可以包含以下SECURITY_INFORMATION标志:

含义

OWNER_SECURITY_INFORMATION

包括所有者。

GROUP_SECURITY_INFORMATION

包括主机组。

DACL_SECURITY_INFORMATION

包括DACL。

SACL_SECURITY_INFORMATION

包括SACL。

如果DACL是NULL,并SE_DACL_PRESENT控件位在输入安全说明符设置,方法失败。

如果DACL是NULL,并SE_DACL_PRESENT控件位在输入安全说明符未设置,发生的安全说明符字符串没有D:元素。有关详细信息 安全说明符字符串格式 参见。

因为它调用 ConvertStringSecurityDescriptorToSecurityDescriptor,此方法对于Windows 2000才可用和更高版本。

要求

Header: atlsecurity.h

请参见

参考

CSecurityDesc选件类

SECURITY_DESCRIPTOR

CSecurityDesc::FromString