The GetSecurityDescriptorControl function retrieves a security descriptor's control and revision information.
BOOL GetSecurityDescriptorControl(
| PSECURITY_DESCRIPTOR pSecurityDescriptor, | // address of security descriptor |
| PSECURITY_DESCRIPTOR_CONTROL pControl, | // address of control structure |
| LPDWORD lpdwRevision | // address of revision value |
| ); |
Parameters
pSecurityDescriptor
Points to a SECURITY_DESCRIPTOR structure whose control and revision information the function retrieves.
pControl
Points to a SECURITY_DESCRIPTOR_CONTROL structure receiving the security descriptor's control information.
lpdwRevision
Points to a variable receiving the security descriptor's revision value. This value is always set, even when GetSecurityDescriptorControl returns an error.
Return Values
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.
See Also
GetSecurityDescriptorDacl, GetSecurityDescriptorGroup, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL