CSecurityDesc::FromString

Converts a string-format security descriptor into a valid, functional security descriptor.

Syntax

      bool FromString(
   LPCTSTR pstr 
) throw(...);

Parameters

• pstr
  Pointer to a null-terminated string that contains the string-format security descriptor to be converted.

Return Value

Returns true on success. Throws an exception on failure.

Remarks

The string can be created by using CSecurityDesc::ToString. Converting the security descriptor into a string makes it easier to store and transmit.

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

Requirements

Header: atlsecurity.h

See Also

CSecurityDesc Class
ConvertSecurityDescriptorToStringSecurityDescriptor
SECURITY_DESCRIPTOR
CSecurityDesc::ToString