ddpi_variable_get_full_name operation

The ddpi_variable_get_full_name operation returns the fully qualified name (which is prefixed with the C++ class name, if applicable) of the variable. The actual version of the name is returned, not a copy. The user must never deallocate the returned pointer.

Prototype

int ddpi_variable_get_full_name(
   Ddpi_Variable         variable,
   char**                ret_full_name,
   Ddpi_Error*           error);

Parameters

variable: Input. This accepts the Ddpi_Variable object for the variable.
ret_full_name: Output. This returns the fully qualified name of the variable.
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:

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