CSecurityDesc::FromString (ATL)

ATL Library Reference

CSecurityDesc::FromString

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

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

pstr: Pointer to a null-terminated string containing the string-format security descriptor to convert.

Return Value

Returns true on success, false on failure.

Remarks

The string can be created 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 as it calls ConvertStringSecurityDescriptorToSecurityDescriptor.