CSecurityDesc::ToString

Konvertiert eine Sicherheitsbeschreibung zu einem Zeichenfolgenformat.

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

Parameter

• pstr
  Zeiger auf eine auf NULL endende Zeichenfolge, die Zeichenkettenformatsicherheitsbeschreibung empfängt.

• si
  Gibt eine Kombination von SECURITY_INFORMATIONS-Bitflags an, um die Komponenten der Sicherheitsbeschreibung anzugeben, die in der Ausgabezeichenfolge einzuschließen.

Rückgabewert

Gibt bei Erfolg true zurück, bei einem Fehler false.

Hinweise

Sobald die Sicherheitsbeschreibung im Zeichenfolgenformat ist, kann sie leicht gespeichert werden oder gesendet werden.Verwenden Sie die CSecurityDesc::FromString-Methode, um die Zeichenfolge zurück in eine Sicherheitsbeschreibung zu konvertieren.

Der si-Parameter kann die folgenden SECURITY_INFORMATIONS-Flags enthalten:

Wenn die DACL NULL ist und der SE_DACL_PRESENT-Steuerbit in der Eingabesicherheitsbeschreibung festgelegt ist, schlägt die Methode fehl.

Wenn die DACL NULL ist und der SE_DACL_PRESENT-Steuerbit nicht in der Eingabesicherheitsbeschreibung festgelegt wird, hat die resultierende Sicherheitsbeschreibungszeichenfolge nicht D: Komponente.Siehe Sicherheitsbeschreibungs-Zeichenkettenformat für weitere Details.

Diese Methode ist mit Windows 2000 und höher nur verfügbar, da sie ConvertStringSecurityDescriptorToSecurityDescriptor aufruft.

Anforderungen

Header: atlsecurity.h

Siehe auch

Referenz

CSecurityDesc-Klasse

SECURITY_DESCRIPTOR

CSecurityDesc::FromString