GetSecurityDescriptorControl

  BOOL GetSecurityDescriptorControl(SecurityDescriptor, Control, lpdwRevision)    
  PSECURITY_DESCRIPTOR SecurityDescriptor;    
  PSECURITY_DESCRIPTOR_CONTROL Control;    
  LPDWORD lpdwRevision;    

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

Parameters

SecurityDescriptor

Pointer to a SECURITY_DESCRIPTOR data structure whose control and revision information the function will retrieve.

Control

Pointer to a SECURITY_DESCRIPTOR_CONTROL data structure that the function will fill with the security descriptor's control information.

lpdwRevision

Pointer to a variable that the function will set to the security descriptor's revision value. This value will always be set, even if GetSecurityDescriptorControl returns an error.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.

See Also

GetSecurityDescriptorGroup, GetSecurityDescriptorDacl, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, InitializeSecurityDescriptor, IsValidSecurityDescriptor, SetSecurityDescriptorDacl, SetSecurityDescriptorGroup, SetSecurityDescriptorOwner, SetSecurityDescriptorSacl