bonobo-moniker-extender: Libbonobo Reference Manual

bonobo-moniker-extender

Functions

Bonobo_Unknown	(*BonoboMonikerExtenderFn) ()
BonoboMonikerExtender *	bonobo_moniker_extender_new ()
Bonobo_MonikerExtender	bonobo_moniker_find_extender ()
Bonobo_Unknown	bonobo_moniker_use_extender ()

Types and Values

struct	BonoboMonikerExtender
	BonoboMonikerExtenderClass

Object Hierarchy

    GObject
    ╰── BonoboObject
        ╰── BonoboMonikerExtender

Description

Functions

BonoboMonikerExtenderFn ()

Bonobo_Unknown
(*BonoboMonikerExtenderFn) (BonoboMonikerExtender *extender,
                            const Bonobo_Moniker parent,
                            const Bonobo_ResolveOptions *options,
                            const CORBA_char *display_name,
                            const CORBA_char *requested_interface,
                            CORBA_Environment *ev);

bonobo_moniker_extender_new ()

BonoboMonikerExtender *
bonobo_moniker_extender_new (BonoboMonikerExtenderFn resolve,
                             gpointer data);

This creates a new moniker extender.

Parameters

resolve	the resolve function that will be used to do the extension
data	user data to be passed back to the resolve function.

Returns

the extender object

bonobo_moniker_find_extender ()

Bonobo_MonikerExtender
bonobo_moniker_find_extender (const gchar *name,
                              const gchar *interface,
                              CORBA_Environment *opt_ev);

This routine tries to locate an extender for our moniker by examining a registry of extenders that map new interfaces to certain moniker names.

Parameters

name	the name of the moniker we want to extend eg. 'file:'
interface	the interface we want to resolve to
opt_ev	an optional corba exception environment.

Returns

an appropriate extender or CORBA_OBJECT_NIL.

bonobo_moniker_use_extender ()

Bonobo_Unknown
bonobo_moniker_use_extender (const gchar *extender_oafiid,
                             BonoboMoniker *moniker,
                             const Bonobo_ResolveOptions *options,
                             const CORBA_char *requested_interface,
                             CORBA_Environment *opt_ev);

Locates a known extender via. OAFIID; eg. OAFIID:Bonobo_Moniker_Extender_file

Parameters

extender_oafiid	The IID of the extender to use
moniker	the moniker to extend
options	resolve options
requested_interface	the requested interface
opt_ev	optional corba environment

Returns

the resolved result or CORBA_OBJECT_NIL.

Types and Values

struct BonoboMonikerExtender

struct BonoboMonikerExtender;

BonoboMonikerExtenderClass

typedef struct {
	BonoboObjectClass      parent_class;

	POA_Bonobo_MonikerExtender__epv epv;

	BonoboMonikerExtenderFn resolve;
} BonoboMonikerExtenderClass;