GetSecurityDescriptorLength function (securitybaseapi.h)
The GetSecurityDescriptorLength function returns the length, in bytes, of a structurally valid security descriptor. The length includes the length of all associated structures.
Syntax
DWORD GetSecurityDescriptorLength(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parameters
[in] pSecurityDescriptor
A pointer to the SECURITY_DESCRIPTOR structure whose length the function returns. The pointer is assumed to be valid.
Return value
If the function succeeds, the function returns the length, in bytes, of the SECURITY_DESCRIPTOR structure.
If the SECURITY_DESCRIPTOR structure is not valid, 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 security identifiers (SIDs) or access control lists (ACLs).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | securitybaseapi.h (include Windows.h) |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |