ddpi_function_get_access operation

The ddpi_function_get_access operation returns the Ddpi_Access object whose Dwarf_Debug object contains the function instance. The actual Ddpi_Access object is returned, not a copy. The user must never deallocate the returned pointer.

Prototype

int ddpi_function_get_access(
   Ddpi_Function         function,
   Ddpi_Access*          ret_access,
   Ddpi_Error*           error);

Parameters

function: Input. This accepts the Ddpi_Function object for the function.
ret_access: Output. This returns the Ddpi_Access object whose Dwarf_Debug object contains the function instance.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

This value is returned upon successful completion of the operation.

DW_DLV_NO_ENTRY

This value is never returned.

DW_DLV_ERROR

This value is returned if:

function is NULL or invalid.
The Ddpi_Elf, Ddpi_Access or Ddpi_Info object associated with the function is either NULL or invalid.
ret_full_name is NULL.