Retrieves a pointer for the ENOVIA Application.
Role: Starting point when working with the XBom.
Design Pattern:
the construction of the ENOVApplication object which implements
the
ENOVIApplication interface follows the singleton design pattern, this is insured by giving
this function as the sole mean to get an object implementing this interface.
Lifecycle rules deviation:
when this function is called for the first time the singleton object is
constructed and a pointer is kept and AddReffed. This object is not
destroyed until the server exits.
Precondition:
oApplication is a valid pointer.
Parameters:
oApplication
address of the pointer to the application.
Returns:
An HRESULT value.
Legal values:
S_OK
All went well and the interface pointer is successfully returned