bonobo-shlib-factory

bonobo-shlib-factory —

Synopsis




            BonoboShlibFactory;
            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

BonoboShlibFactory

typedef struct _BonoboShlibFactory BonoboShlibFactory;

BonoboShlibFactoryClass

typedef struct {
	BonoboGenericFactoryClass parent_class;
} BonoboShlibFactoryClass;

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