CSecurityDesc::MakeSelfRelative

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

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

Concepts

CSecurityDesc Class

CSecurityDesc Members

SECURITY_DESCRIPTOR_CONTROL

Absolute and Self-Relative Security Descriptors

CSecurityDesc::MakeAbsolute

CSecurityDesc::IsSelfRelative

MakeSelfRelativeSD