bonobo-shlib-factory

bonobo-shlib-factory —

Synopsis




struct      BonoboShlibFactory;
struct      BonoboShlibFactoryClass;
BonoboShlibFactory* bonobo_shlib_factory_construct
                                            (BonoboShlibFactory *factory,
                                             const char *act_iid,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             GClosure *closure);
BonoboShlibFactory* bonobo_shlib_factory_new
                                            (const char *component_id,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             BonoboFactoryCallback factory_cb,
                                             gpointer user_data);
BonoboShlibFactory* bonobo_shlib_factory_new_closure
                                            (const char *act_iid,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             GClosure *factory_closure);
Bonobo_Unknown bonobo_shlib_factory_std     (const char *component_id,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             BonoboFactoryCallback factory_cb,
                                             gpointer user_data,
                                             CORBA_Environment *ev);
#define     BONOBO_OAF_SHLIB_FACTORY        (oafiid, descr, fn, data)
#define     BONOBO_OAF_SHLIB_FACTORY_MULTI  (oafiid, descr, fn, data)
#define     BONOBO_ACTIVATION_SHLIB_FACTORY (oafiid, descr, fn, data)


Object Hierarchy


  GObject
   +----BonoboObject
         +----BonoboGenericFactory
               +----BonoboShlibFactory

Description

Details

struct BonoboShlibFactory

struct BonoboShlibFactory;


struct BonoboShlibFactoryClass

struct BonoboShlibFactoryClass {

	BonoboGenericFactoryClass parent_class;
};


bonobo_shlib_factory_construct ()

BonoboShlibFactory* bonobo_shlib_factory_construct
                                            (BonoboShlibFactory *factory,
                                             const char *act_iid,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             GClosure *closure);

Initializes c_factory with the supplied data.

factory : The object to be initialized.
act_iid : The GOAD id that the new factory will implement.
poa : the poa.
act_impl_ptr : Activation shlib handle
closure : The closure used to create new GnomeShlib object instances.
Returns : The initialized BonoboShlibFactory object.

bonobo_shlib_factory_new ()

BonoboShlibFactory* bonobo_shlib_factory_new
                                            (const char *component_id,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             BonoboFactoryCallback factory_cb,
                                             gpointer user_data);

This is a helper routine that simplifies the creation of factory objects for GNOME objects. The factory function will be invoked by the CORBA server when a request arrives to create a new instance of an object supporting the Bonobo::Shlib interface. The factory callback routine is passed the data pointer to provide the creation function with some state information.

component_id : The GOAD id that this factory implements
poa : the poa.
act_impl_ptr : Activation shlib handle
factory_cb : A callback which is used to create new BonoboObject instances.
user_data : The closure data to be passed to the factory callback routine.
Returns : A BonoboShlibFactory object that has an activated Bonobo::ShlibFactory object that has registered with the GNOME name server.

bonobo_shlib_factory_new_closure ()

BonoboShlibFactory* bonobo_shlib_factory_new_closure
                                            (const char *act_iid,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             GClosure *factory_closure);

This is a helper routine that simplifies the creation of factory objects for GNOME objects. The factory_closure closure will be invoked by the CORBA server when a request arrives to create a new instance of an object supporting the Bonobo::Shlib interface. The factory callback routine is passed the data pointer to provide the creation function with some state information.

act_iid : The GOAD id that this factory implements
poa : the poa.
act_impl_ptr : Activation shlib handle
factory_closure : A closure which is used to create new BonoboObject instances.
Returns : A BonoboShlibFactory object that has an activated Bonobo::ShlibFactory object that has registered with the GNOME name server.

bonobo_shlib_factory_std ()

Bonobo_Unknown bonobo_shlib_factory_std     (const char *component_id,
                                             PortableServer_POA poa,
                                             gpointer act_impl_ptr,
                                             BonoboFactoryCallback factory_cb,
                                             gpointer user_data,
                                             CORBA_Environment *ev);

A Generic std shlib routine so we don't stick a load of code inside a public macro.

component_id :
poa :
act_impl_ptr :
factory_cb :
user_data :
ev :
Returns : 0 on success, 1 on failure.

BONOBO_OAF_SHLIB_FACTORY()

#define     BONOBO_OAF_SHLIB_FACTORY(oafiid, descr, fn, data)

Deprecated. See BONOBO_ACTIVATION_SHLIB_FACTORY().

oafiid :
descr :
fn :
data :

BONOBO_OAF_SHLIB_FACTORY_MULTI()

#define     BONOBO_OAF_SHLIB_FACTORY_MULTI(oafiid, descr, fn, data)

Deprecated. See BONOBO_ACTIVATION_SHLIB_FACTORY().

oafiid :
descr :
fn :
data :

BONOBO_ACTIVATION_SHLIB_FACTORY()

#define     BONOBO_ACTIVATION_SHLIB_FACTORY(oafiid, descr, fn, data)

Macro that includes all boiler-plate code necessary to create an shlib type factory.

oafiid :The factory's OAFIID
descr :Description of the factory
fn :Function (BonoboFactoryCallback) responsible for intantiating components
data :Additional data to be passed to the callback