GetSecurityDescriptorLength function
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 WINAPI GetSecurityDescriptorLength( _In_ PSECURITY_DESCRIPTOR pSecurityDescriptor );
Parameters
- pSecurityDescriptor [in]
-
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
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Low-level Access Control
- Low-level Access Control Functions
- GetSecurityDescriptorControl
- GetSecurityDescriptorDacl
- GetSecurityDescriptorGroup
- GetSecurityDescriptorOwner
- GetSecurityDescriptorSacl
- IsValidSecurityDescriptor
- SECURITY_DESCRIPTOR