CSecurityDesc::ToString

Articolo
06/09/2015

Converte un descrittore di sicurezza in un formato stringa.

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

Parametri

pstr
Puntatore a una stringa con terminazione null che riceverà descrittore di sicurezza di formato stringa.
si
Specifica una combinazione di flag di bit di SECURITY_INFORMATION per indicare i componenti del descrittore di sicurezza da includere nella stringa di output.

Valore restituito

Restituisce true se l'operazione ha esito positivo, false in caso di esito negativo.

Note

Una volta che il descrittore di sicurezza in formato stringa, può più essere archiviato o trasmessoe. Utilizzare il metodo CSecurityDesc::FromString per convertire la stringa in un descrittore di sicurezza.

Il parametro si può contenere i seguenti flag di SECURITY_INFORMATION:

Valore	Significato
OWNER_SECURITY_INFORMATION	Importare il proprietario.
GROUP_SECURITY_INFORMATION	Includere il gruppo primario.
DACL_SECURITY_INFORMATION	Importare il DACL.
SACL_SECURITY_INFORMATION	Importare il SACL.

Se il DACL è NULL e il bit del controllo di SE_DACL_PRESENT è impostato nel descrittore di sicurezza di input, il metodo non riesce.

Se il DACL è NULL e il bit del controllo di SE_DACL_PRESENT non è impostato nel descrittore di sicurezza di input, la stringa risultante del descrittore di sicurezza non ha una D: componente. Vedere Stringa del descrittore di sicurezza per ulteriori informazioni.

Questo metodo è disponibile solo in Windows 2000 e versioni successive, che chiama ConvertStringSecurityDescriptorToSecurityDescriptor.