2-119
DSOM Framework Reference
somdRefFromSOMObj Method
Purpose
Returns an object reference corresponding to the specified SOM object.
IDL Syntax
SOMDObject somdRefFromSOMObj (
in SOMObject somobj);
Description
The somdRefFromSOMObj method creates a simple (transient) reference to a SOM
object. This method is called by SOMOA as part of converting the results of a local method
call into a result message for a remote client.
By default the somdRefFromSOMObj method turns over ownership of the object reference
it creates to the caller. However, if a subclass of SOMDServer overrides
somdRefFromSOMObj to implement object reference caching, then that subclass should
also override the method somdObjReferencesCached to report that caching by returning
TRUE.
Parameters
receiver A pointer to a SOMDServer object.
env A pointer to the Environment structure for the method caller.
somobj A pointer to the SOM object for which a DSOM reference is to be created.
Return Value
The somdRefFromSOMObj method returns a DSOM reference (that is, a SOMDObject)
for the SOM object specified.
Example
#include <somd.h>
#include <stack.ih> /* user–generated */
SOMDObject objref;
Environment ev;
SOMObject obj;
...
/* myServer specific code up here */
...
/* one might want to make this call as part of the code
* that overrides the somdRefFromSOMObj method, i.e.
* in an implementation of a subclass of SOMDServer called
* myServer
*/
objref =
myServer_parent_SOMDServer_somdRefFromSOMObj(somSelf, &ev, obj);
Original Class
SOMDServer
Related Information
Method: somdObjReferencesCached
Comentários a estes Manuais