CSecurityDesc::FromString

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

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

Reference

CSecurityDesc Class

ConvertSecurityDescriptorToStringSecurityDescriptor

SECURITY_DESCRIPTOR

CSecurityDesc::ToString

Other Resources

CSecurityDesc Members

Change History

Date	History	Reason
July 2009	Corrected return value on failure.	Customer feedback.