ddpi_module_find_space operation

The ddpi_module_find_space operation returns the Ddpi_Space object that directly or indirectly owns the given Ddpi_Module object.

Description

A Ddpi_Module object can be either active or hidden. If it is active, then the Ddpi_Module object is owned by a Ddpi_Process object. If it is hidden, the Ddpi_Module object is on the hidden-module list, and is owned directly by the Ddpi_Space object.

Prototype

int  ddpi_module_find_space(         
      Ddpi_Module         module,   
      Ddpi_Space*         ret_space,
      Ddpi_Error*         error);

Parameters

module: Input. This accepts the Ddpi_Module object.
ret_space: Output. This returns the Ddpi_Space object for this instance.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

Returned upon successful retrieval of the module owner.

DW_DLV_NO_ENTRY

Never returned.

DW_DLV_ERROR

This value is returned if:

module is NULL.
The Ddpi_Info object associated with module is NULL.
ret_space is NULL.