CSecurityDesc::ToString

Článek
06/09/2015

Popisovač zabezpečení se převede na formát řetězce.

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

Parametry

pstr
Ukazatel na řetězec zakončený hodnotou null, který se zobrazí Formát řetězce popisovače zabezpečení.
si
Určuje kombinaci SECURITY_INFORMATION bitové příznaky označit součásti zahrnout výstupní řetězec popisovače zabezpečení.

Vrácená hodnota

Vrátí hodnotu true při úspěchu, false při selhání.

Poznámky

Jakmile ve formátu řetězce popisovače zabezpečení, může být snadněji uchovávaných nebo přenášených.Použití CSecurityDesc::FromString metoda převést řetězec zpět do popisovače zabezpečení.

si Parametr může obsahovat následující příznaky SECURITY_INFORMATION:

Value	Význam
OWNER_SECURITY_INFORMATION	Patří vlastník.
GROUP_SECURITY_INFORMATION	Primární skupina patří.
DACL_SECURITY_INFORMATION	Zahrnout seznam DACL.
SACL_SECURITY_INFORMATION	Zahrnout seznam SACL.

Pokud je nastaven bit ovládacího prvku SE_DACL_PRESENT v popisovači zabezpečení vstupních DACL je NULL, metoda selže.

Pokud není nastaven bit ovládacího prvku SE_DACL_PRESENT v popisovači zabezpečení vstupních DACL je NULL, výsledný řetězec popisovače zabezpečení součásti D: nemá.Viz Formát řetězce popisovače zabezpečení další podrobnosti.

Tato metoda je k dispozici pouze v systému Windows 2000 a novější, jak volá ConvertStringSecurityDescriptorToSecurityDescriptor.