get_descriptor_discretionary_access_list


bool get_descriptor_discretionary_access_list(void* security,
                                              bool* present,
                                              access_list** list,
                                              bool* defaulted)

This function obtains a pointer to the discretionary access list of a descriptor.

Parameters

void* security

A pointer to the whose discretionary access list is being queried.

bool* present

A pointer to a boolean variable that is updated to indicate the presence of a discretionary access list. If null is specified, no update is performed. False is returned when the discretionary access list is not present; and true otherwise.

access_list** list

A pointer to a variable that is updated to point at the discretionary access list for the descriptor. If no discretionary access list exists, null is returned. If a discretionary access list exists and null is returned, a null discretionary access list is present. This implies all access is allowed.

bool* defaulted

A pointer to a boolean variable that is updated to indicate whether the access list was provided via a default mechanism. If null is specified, no update is performed. The descriptor control flag descriptor_control::DiscretionaryDefaulted determines this value.

Return

bool

true The function succeeded.
false The call failed.