Share via

CSecurityDesc::MakeSelfRelative

  • Article

 

Call this method to convert the security descriptor to self-relative format.

Syntax

bool MakeSelfRelative( ) throw(...);

Return Value

Returns true if the method succeeds, false otherwise.

Remarks

A security descriptor in absolute format contains pointers to the information it contains, rather than containing the information itself. A security descriptor in self-relative format contains the information in a contiguous block of memory. In a self-relative security descriptor, a SECURITY_DESCRIPTOR structure always starts the information, but the security descriptor's other components can follow the structure in any order. Instead of using memory addresses, the components of the security descriptor are identified by offsets from the beginning of the security descriptor. This format is useful when a security descriptor must be stored on a disk or transmitted by means of a communications protocol. For more information, see Absolute and Self-Relative Security Descriptors.

Requirements

Header: atlsecurity.h

See Also

CSecurityDesc Class
SECURITY_DESCRIPTOR_CONTROL
Absolute and Self-Relative Security Descriptors
CSecurityDesc::MakeAbsolute
CSecurityDesc::IsSelfRelative
MakeSelfRelativeSD