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 |
|
|
Library |
|
|
DLL |
|
See also
- Access Control Overview
- Basic Access Control Functions
- GetSecurityDescriptorDacl
- GetSecurityDescriptorGroup
- GetSecurityDescriptorLength
- GetSecurityDescriptorOwner
- GetSecurityDescriptorSacl
- IsValidSecurityDescriptor
- SECURITY_DESCRIPTOR
- SECURITY_DESCRIPTOR_CONTROL