CSecurityDesc::ToString (ATL)

CSecurityDesc::ToString

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

ATL Library Reference

CSecurityDesc::ToString

Converts a security descriptor to a string format.

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

Parameters

pstr: Pointer to a null-terminated string which will receive the string-format security descriptor.

si: Specifies a combination of SECURITY_INFORMATION bit flags to indicate the components of the security descriptor to include in the output string.

Return Value

Returns true on success, false on failure.

Remarks

Once the security descriptor is in string format, it can more easily be stored or transmitted. Use the CSecurityDesc::FromString method to convert the string back into a security descriptor.

The si parameter can contain the following SECURITY_INFORMATION flags:

Value	Meaning
OWNER_SECURITY_INFORMATION	Include the owner.
GROUP_SECURITY_INFORMATION	Include the primary group.
DACL_SECURITY_INFORMATION	Include the DACL.
SACL_SECURITY_INFORMATION	Include the SACL.

If the DACL is NULL and the SE_DACL_PRESENT control bit is set in the input security descriptor, the method fails.

If the DACL is NULL and the SE_DACL_PRESENT control bit is not set in the input security descriptor, the resulting security descriptor string does not have a D: component. See Security Descriptor String Format for more details.

This method is only available with Windows 2000 and later, as it calls ConvertStringSecurityDescriptorToSecurityDescriptor.

Reference

CSecurityDesc Class
SECURITY_DESCRIPTOR
CSecurityDesc::FromString

Other Resources

CSecurityDesc Members