Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GetSecurityDescriptorLength
Collapse the table of content
Expand the table of content

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

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

Low-level Access Control
Low-level Access Control Functions
GetSecurityDescriptorControl
GetSecurityDescriptorDacl
GetSecurityDescriptorGroup
GetSecurityDescriptorOwner
GetSecurityDescriptorSacl
IsValidSecurityDescriptor
SECURITY_DESCRIPTOR

 

 

Community Additions

ADD
Show:
© 2015 Microsoft