GetSecurityDescriptorLength
The GetSecurityDescriptorLength
function returns the length, in bytes, of a structurally valid SECURITY_DESCRIPTOR structure. The length
includes the length of all associated structures, such as SID and ACL
structures.
DWORD GetSecurityDescriptorLength(
|
PSECURITY_DESCRIPTOR pSecurityDescriptor |
// address of
security descriptor |
|
); |
|
Parameters
pSecurityDescriptor
Points to the
SECURITY_DESCRIPTOR structure whose length the function returns. The SECURITY_DESCRIPTOR
structure is assumed to be valid.
Return Values
If the
function succeeds, the return value is the length, in bytes, of the SECURITY_DESCRIPTOR
structure. If the SECURITY_DESCRIPTOR structure is invalid, the return
value is undefined.
Remarks
The minimum
length of a security descriptor is SECURITY_DESCRIPTOR_MIN_LENGTH. A security
descriptor of this length has no associated SID or ACL
structures.
See Also