CSecurityDesc::ToString
Convertit un modèle de sécurité à un format de chaîne.
bool ToString(
CString * pstr,
SECURITY_INFORMATION si = OWNER_SECURITY_INFORMATION |
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
SACL_SECURITY_INFORMATION
) const throw(...);
Paramètres
pstr
Pointeur vers une chaîne terminée par le caractère NULL qui recevra modèle de format de chaîne.si
Spécifie une combinaison des bits indicateurs de SECURITY_INFORMATION pour indiquer les composants du modèle de sécurité à inclure dans la chaîne de sortie.
Valeur de retour
Retourne la valeur true en cas de réussite, false en cas d'échec.
Notes
Une fois que le modèle de sécurité est au format de chaîne, il peut facilement être stocké ou transmis.Utilisez la méthode d' CSecurityDesc::FromString pour convertir la chaîne dans le dans un modèle de sécurité.
Le paramètre d' si peut contenir les balises suivantes de SECURITY_INFORMATION :
Valeur |
Signification |
|---|---|
OWNER_SECURITY_INFORMATION |
Incluez le propriétaire. |
GROUP_SECURITY_INFORMATION |
Incluez le groupe principal. |
DACL_SECURITY_INFORMATION |
Incluez la liste DACL nulle. |
SACL_SECURITY_INFORMATION |
Incluez SACL. |
Si la liste DACL nulle est NULL et le bit de contrôle de SE_DACL_PRESENT est défini dans le modèle d'entrée de sécurité, la méthode échoue.
Si la liste DACL nulle est NULL et le bit de contrôle de SE_DACL_PRESENT n'est pas défini dans le modèle d'entrée de sécurité, la chaîne de descripteur résultant de sécurité n'a pas de D : composant.Consultez format de chaîne de descripteur de sécurité pour plus de détails.
Cette méthode est uniquement disponible avec Windows 2000 et versions ultérieures, car elle appelle ConvertStringSecurityDescriptorToSecurityDescriptor.
Configuration requise
Header: atlsecurity.h