bonobo-shlib-factory

## 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