共用方式為

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。

備註

一旦安全性描述元字串格式，可以更輕鬆地儲存或傳輸。 使用方法 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 Class

SECURITY_DESCRIPTOR

CSecurityDesc::FromString