BOOL GetSecurityDescriptorGroup(SecurityDescriptor, Group, lpfGroupDefaulted) | |||
PSECURITY_DESCRIPTOR SecurityDescriptor; | |||
PSID * Group; | |||
LPBOOL lpfGroupDefaulted; |
The GetSecurityDescriptorGroup function retrieves the primary group information of a security descriptor.
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.
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.
GetSecurityDescriptorControl, GetSecurityDescriptorDacl, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, InitializeSecurityDescriptor, IsValidSecurityDescriptor, SetSecurityDescriptorDacl, SetSecurityDescriptorGroup, SetSecurityDescriptorOwner, SetSecurityDescriptorSacl