GetSecurityDescriptorGroup
The GetSecurityDescriptorGroup
function retrieves the primary group information from a security descriptor.
BOOL GetSecurityDescriptorGroup(
|
PSECURITY_DESCRIPTOR pSecurityDescriptor, |
// address of
security descriptor |
|
PSID *pGroup, |
// address of
pointer to group security identifier (SID) |
|
LPBOOL lpbGroupDefaulted |
// address of flag
for default |
|
); |
|
Parameters
pSecurityDescriptor
Points to a SECURITY_DESCRIPTOR structure whose primary
group information the function retrieves.
pGroup
Points to a
pointer to a SID
structure identifying the primary group when the function returns. (A SID is a
security identifier.) If the security descriptor does not contain a primary
group, the function sets the pointer pointed to by pGroup to NULL and
ignores the remaining output parameter, lpbGroupDefaulted. If the
security descriptor contains a primary group, the function sets the pointer
pointed to by pGroup to the address of the security descriptor s group SID
structure and provides a valid value for the variable pointed to by lpbGroupDefaulted.
lpbGroupDefaulted
Points to a
flag set to the value of the SE_GROUP_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure when the function
returns. If the value stored in the variable pointed to by the pGroup
parameter is NULL, no value is set.
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