GetSecurityDescriptorControl  L9T949 

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_DESCRIPTOR188MR8K structure whose control and revision information the function retrieves.

pControl

Points to a SECURITY_DESCRIPTOR_CONTROL3773D5 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 GetLastError11C2VS7.

See Also

GetSecurityDescriptorDacl, GetSecurityDescriptorGroup, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL