GetSecurityDescriptorGroup

  BOOL GetSecurityDescriptorGroup(SecurityDescriptor, Group, lpfGroupDefaulted)    
  PSECURITY_DESCRIPTOR SecurityDescriptor;    
  PSID * Group;    
  LPBOOL lpfGroupDefaulted;    

The GetSecurityDescriptorGroup function retrieves the primary group information of a security descriptor.

Parameters

SecurityDescriptor

Pointer to a SECURITY_DESCRIPTOR data structure whose primary group information the function will retrieve.

The SECURITY_DESCRIPTOR data structure has the following form:

typedef PVOID PSECURITY_DESCRIPTOR;

Group

Pointer to a pointer to a SID. If the security descriptor does not currently contain a primary group, the function will set the pointer pointed to by Group to NULL, and will ignore the remaining output parameter, lpfGroupDefaulted. If the security descriptor does contain an owner, the function will set the pointer pointed to by Group to the address of the security descriptor's group SID, and will provide a valid value for the variable pointed to by lpfGroupDefaulted.

lpfGroupDefaulted

Pointer to a Boolean variable. If the value stored into the variable pointed to by Group is not NULL, the function sets the variable pointed to by lpfGroupDefaulted to the value of the security descriptor's GroupDefaulted control flag. If the value stored into the variable pointed to by Group is NULL, no value is set.

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

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