2-65
DSOM Framework Reference
somdNewObject Method
Purpose
Returns a new object of the named class.
IDL Syntax
SOMObject somdNewObject (
in Identifier objclass,
in string hints);
Description
The somdNewObject method returns a new object of the class specified by objclass.
Application-specific creation options can be supplied via the hints parameter.
In DSOM, the SOMDObjectMgr selects a random server which has advertised knowledge
of the desired class objclass, and forwards the creation request to that server. The hints
field is currently ignored by the SOMDObjectMgr.
Parameters
receiver A pointer to an ObjectMgr object.
env A pointer to the Environment structure for the method caller.
objclass An Identifier representing the type of the new object.
hints A string which may optionally be used to specify special creation options.
Return Value
The somdNewObject method returns a SOMObject. Ownership of the new object is
transferred to the caller.
Example
#include <somd.h>
#include <stack.h> /* provided by user */
Stack stk;
Environment ev;
SOMDServer server;
SOM_InitEnvironment(&ev);
SOMD_Init(&ev);
StackNewClass(0,0);
stk = _somdNewObject(SOMD_ObjectMgr, &ev, ”Stack”, ””);
...
_somdDestroyObject(SOMD_ObjectMgr, &ev, stk);
Original Class
ObjectMgr
Related Information
Methods: somdDestroyObject, somdReleaseObject
Kommentare zu diesen Handbüchern