Export (0) Print
Expand All
Expand Minimize

GetSecurityDescriptorControl function

The GetSecurityDescriptorControl function retrieves a security descriptor control and revision information.

Syntax


BOOL WINAPI GetSecurityDescriptorControl(
  _In_   PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Out_  PSECURITY_DESCRIPTOR_CONTROL pControl,
  _Out_  LPDWORD lpdwRevision
);

Parameters

pSecurityDescriptor [in]

A pointer to a SECURITY_DESCRIPTOR structure whose control and revision information the function retrieves.

pControl [out]

A pointer to a SECURITY_DESCRIPTOR_CONTROL structure that receives the security descriptor's control information.

lpdwRevision [out]

A pointer to a variable that receives the security descriptor's revision value. This value is always set, even when GetSecurityDescriptorControl returns an error.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

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

Access Control Overview
Basic Access Control Functions
GetSecurityDescriptorDacl
GetSecurityDescriptorGroup
GetSecurityDescriptorLength
GetSecurityDescriptorOwner
GetSecurityDescriptorSacl
IsValidSecurityDescriptor
SECURITY_DESCRIPTOR
SECURITY_DESCRIPTOR_CONTROL

 

 

Community Additions

ADD
Show:
© 2014 Microsoft