ddpi_process_get_name operation

The ddpi_process_get_name operation queries the name of a given Ddpi_Process object and sets the returned name to a pointer to a null-terminated string of characters.

Description

Never deallocate the returned pointer because ddpi_process_get_name returns the actual version of the name, and not a copy.

Prototype

int ddpi_process_get_name(          
  Ddpi_Process             process,    
  char**                  ret_name,
  Ddpi_Error*             error);

Parameters

process: Input. This accepts the Ddpi_Process object.
ret_name: Output. This returns the name string.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

Returned upon successful assignment of the process name.

DW_DLV_NO_ENTRY

Returned if name is NULL.

DW_DLV_ERROR

Returned if:

process is NULL
Ddpi_Info associated with process is NULL
ret_name is NULL