get_descriptor_group


bool get_descriptor_group(void* security,
                          identity** group,
                          bool* defaulted)

This function obtains a pointer to the identity of the descriptor's primary group.

Parameters

void* security

A pointer to the whose group is being queried.

identity** group

A pointer to a variable that is updated to point at the identity of the group of the descriptor.

bool* defaulted

If non-null, this parameter points to a boolean variable that is updated to indicate whether the primary group identity was sourced via a default mechanism. The descriptor control flag descriptor_control::group_defaulted determines the value returned. If null is specified, this parameter is ignored.

Return

bool

true The function succeeded.
false The call failed.