get_descriptor_system_access_list


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

This function obtains a pointer to the system access list for the descriptor.

Parameters

void* security

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

bool* present

A pointer to a boolean variable that is updated to indicate the presence of a system access list. If null is specified, no update is performed. False is returned when the access list is not present; and true otherwise. The descriptor control flag descriptor_control::system_present determines this value.

access_list** list

A pointer to a variable that is updated to point at the access list for the descriptor. If no access list exists, the variable is set to null. If an access list exists and null is returned, a null system 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::system_defaulted determines this value.

Return

bool

true The function succeeded.
false The call failed.