<HTML
><HEAD
><TITLE
>bonobo-moniker-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="Bonobo API Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Object Activation and Lifecycle"
HREF="bonobo-object-activation.html"><LINK
REL="PREVIOUS"
TITLE="bonobo-context"
HREF="bonobo-bonobo-context.html"><LINK
REL="NEXT"
TITLE="BonoboObjectClient"
HREF="bonobo-bonobo-object-client.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Bonobo API Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-bonobo-context.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-object-activation.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-object-client.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="BONOBO-BONOBO-MONIKER-UTIL"
>bonobo-moniker-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN1292"
></A
><H2
>Name</H2
>bonobo-moniker-util -- Object activation and construction through monikers.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN1295"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>
void (<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>*BonoboMonikerAsyncFn</A
>) (<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-GET-OBJECT"
>bonobo_get_object</A
> (const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-NEW-FROM-NAME"
>bonobo_moniker_client_new_from_name</A
>
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
>* <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-GET-NAME"
>bonobo_moniker_client_get_name</A
> (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-RESOLVE-DEFAULT"
>bonobo_moniker_client_resolve_default</A
>
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<A
HREF="bonobo-bonobo-object-client.html#BONOBOOBJECTCLIENT"
>BonoboObjectClient</A
>* <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-RESOLVE-CLIENT-DEFAULT"
>bonobo_moniker_client_resolve_client_default</A
>
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-NEW-FROM-NAME-FULL"
>bonobo_moniker_util_new_from_name_full</A
>
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> parent,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
>* <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-GET-PARENT-NAME"
>bonobo_moniker_util_get_parent_name</A
>
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-QI-RETURN"
>bonobo_moniker_util_qi_return</A
>
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *requested_interface,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);
int <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-SEEK-STD-SEPARATOR"
>bonobo_moniker_util_seek_std_separator</A
>
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *str,
int min_idx);
void <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-GET-OBJECT-ASYNC"
>bonobo_get_object_async</A
> (const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
void <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-NEW-FROM-NAME-ASYNC"
>bonobo_moniker_client_new_from_name_async</A
>
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
char* <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-ESCAPE"
>bonobo_moniker_util_escape</A
> (const char *string,
int offset);
char* <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-UTIL-UNESCAPE"
>bonobo_moniker_util_unescape</A
> (const char *string,
int num_chars);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-CLIENT-EQUAL"
>bonobo_moniker_client_equal</A
> (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);
void <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-RESOLVE-ASYNC"
>bonobo_moniker_resolve_async</A
> (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="BONOBO-RESOLVEOPTIONS"
>Bonobo_ResolveOptions</GTKDOCLINK
> *options,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
void <A
HREF="bonobo-bonobo-moniker-util.html#BONOBO-MONIKER-RESOLVE-ASYNC-DEFAULT"
>bonobo_moniker_resolve_async_default</A
>
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data); </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1370"
></A
><H2
>Description</H2
><P
>The moniker utility functions provide two sets of functions:
<P
></P
><UL
><LI
><P
> Helper functions for constructing and resolving monikers,
and a simple get_object method that constructs and resolves
against an interface in a single pass. Also, asynchronous
versions of these methods are provided using the <GTKDOCLINK
HREF="BONOBOASYNC"
>BonoboAsync</GTKDOCLINK
>
code.
</P
></LI
><LI
><P
> Helper functions for the implementation of new custom
monikers are also provided here, along with a lot of the
grunt code neccessary for moniker implementation, particularly
constructing the chained list of sub-monikers that comprises
a complex moniker.
</P
></LI
></UL
></P
><P
>The most useful function to get a feel for what monikers can do
is the <TT
CLASS="FUNCTION"
>bonobo_get_object</TT
> method. This is
used to create a moniker and resolve it against a given interface
like this:
<DIV
CLASS="EXAMPLE"
><A
NAME="AEN1381"
></A
><P
><B
>Example 1. GetObject example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkWidget *
moniker_resolve_demo (void)
{
Bonobo_Control control;
CORBA_Environment ev;
CORBA_exception_init (&ev);
control = bonobo_get_object ("file:/demo/a.jpeg",
"Bonobo/Control", NULL);
if (control == CORBA_OBJECT_NIL)
g_error ("Failed to get object file:/demo/a.jpeg");
return bonobo_widget_new_control (control);
}
</PRE
></TD
></TR
></TABLE
></DIV
>
This also makes a control out of the widget.</P
><P
> It is worth noting that when resolving monikers a contracted
version of the interface name may be used, ommitting the 'IDL:'
prefix and / or the ':0' suffix.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN1385"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN1387"
></A
><H3
><A
NAME="BONOBOMONIKERASYNCFN"
></A
>BonoboMonikerAsyncFn ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void (*BonoboMonikerAsyncFn) (<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1396"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1401"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1406"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1411"
></A
><H3
><A
NAME="BONOBO-GET-OBJECT"
></A
>bonobo_get_object ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> bonobo_get_object (const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>This encapsulates both the parse stage and resolve process of using
a moniker, providing a simple VisualBasic like mechanism for using the
object name space.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1421"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the display name of a moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1426"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1431"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1436"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the requested interface or CORBA_OBJECT_NIL</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1441"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-NEW-FROM-NAME"
></A
>bonobo_moniker_client_new_from_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> bonobo_moniker_client_new_from_name
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>This routine tries to parse a Moniker in string form</P
><P
>eg. file:/tmp/a.tar.gz<GTKDOCLINK
HREF="GZIP"
>gzip</GTKDOCLINK
>:<GTKDOCLINK
HREF="TAR"
>tar</GTKDOCLINK
>:</P
><P
>into a CORBA_Object representation of this that can
later be resolved against an interface.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1455"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the display name of a moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1460"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1465"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a new Moniker handle</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1470"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-GET-NAME"
></A
>bonobo_moniker_client_get_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
>* bonobo_moniker_client_get_name (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1480"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a moniker handle</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1485"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1490"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the display name of the moniker.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1495"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-RESOLVE-DEFAULT"
></A
>bonobo_moniker_client_resolve_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> bonobo_moniker_client_resolve_default
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>This resolves the moniker object against the given interface,
with a default set of resolve options.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1505"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1510"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1515"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1520"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the interfaces resolved to or CORBA_OBJECT_NIL</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1525"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-RESOLVE-CLIENT-DEFAULT"
></A
>bonobo_moniker_client_resolve_client_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="bonobo-bonobo-object-client.html#BONOBOOBJECTCLIENT"
>BonoboObjectClient</A
>* bonobo_moniker_client_resolve_client_default
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>See: bonobo_moniker_client_resolve_default; however this version returns
a BonoboObjectClient wrapped reference.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1535"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1540"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1545"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1550"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a BonoboObjectClient style reference.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1555"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-NEW-FROM-NAME-FULL"
></A
>bonobo_moniker_util_new_from_name_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> bonobo_moniker_util_new_from_name_full
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> parent,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>This routine is used to continue building up the chain
that forms a multi-part moniker. The parent is referenced
as the parent and passed onto the next stage of parsing
the 'name'. We eventually return a moniker handle which
represents the end of a linked list of monikers each
pointing to their parent:</P
><P
>file:/tmp/a.tar.gz <-- gzip: <-- tar: <-- [ this is returned ]</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1567"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A parent moniker to chain to or CORBA_OBJECT_NIL</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1572"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the display name</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1577"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> corba environment</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1582"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> The end node of a list of monikers representing <TT
CLASS="PARAMETER"
><I
>name</I
></TT
></P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1588"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-GET-PARENT-NAME"
></A
>bonobo_moniker_util_get_parent_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
>* bonobo_moniker_util_get_parent_name
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>This gets the display name of the parent moniker ( recursively
all of the parents of this moniker ).</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1598"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1603"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1608"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the display name; use CORBA_free to release it.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1613"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-QI-RETURN"
></A
>bonobo_moniker_util_qi_return ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> bonobo_moniker_util_qi_return
(<GTKDOCLINK
HREF="BONOBO-UNKNOWN"
>Bonobo_Unknown</GTKDOCLINK
> object,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *requested_interface,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev);</PRE
></TD
></TR
></TABLE
><P
>A helper function to share code from the end of a resolve
implementation; this ensures that the returned object is of
the correct interface by doing a queryInterface on the object.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1624"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>object</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the unknown to query</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1629"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>requested_interface</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the desired interface</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1634"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1639"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> an handle to the requested interface</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1644"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-SEEK-STD-SEPARATOR"
></A
>bonobo_moniker_util_seek_std_separator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int bonobo_moniker_util_seek_std_separator
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *str,
int min_idx);</PRE
></TD
></TR
></TABLE
><P
>This looks for a standard separator in a moniker's
display name string. Most monikers will want to use
standard separators.</P
><P
> See also bonobo_moniker_util_escape</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1653"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>str</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the string to scan</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1658"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>min_idx</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the minimum offset at which a separator can be found.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1663"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the position of the standard separator, or a
pointer to the end of the string.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1668"
></A
><H3
><A
NAME="BONOBO-GET-OBJECT-ASYNC"
></A
>bonobo_get_object_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_get_object_async (const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
>An async version of bonobo_get_object</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1680"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1685"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1690"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1695"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>timeout_msec</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the timeout in milliseconds </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1700"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the async callback that gets the response </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1705"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> user context data to pass to that callback </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1710"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-NEW-FROM-NAME-ASYNC"
></A
>bonobo_moniker_client_new_from_name_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_moniker_client_new_from_name_async
(const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
>An asynchronous version of new_from_name</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1722"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1727"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1732"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>timeout_msec</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the timeout in milliseconds </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1737"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the async callback that gets the response</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1742"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> user context data to pass to that callback</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1747"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-ESCAPE"
></A
>bonobo_moniker_util_escape ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char* bonobo_moniker_util_escape (const char *string,
int offset);</PRE
></TD
></TR
></TABLE
><P
>Escapes possible separator characters inside a moniker
these include '!' and '#', the '\' escaping character is
used.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1754"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>string</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> an unescaped string</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1759"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>offset</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> an offset of characters to ignore</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1764"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> an escaped sub-string.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1769"
></A
><H3
><A
NAME="BONOBO-MONIKER-UTIL-UNESCAPE"
></A
>bonobo_moniker_util_unescape ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>char* bonobo_moniker_util_unescape (const char *string,
int num_chars);</PRE
></TD
></TR
></TABLE
><P
>This routine strips <TT
CLASS="PARAMETER"
><I
>num_chars</I
></TT
>: from the start of
<TT
CLASS="PARAMETER"
><I
>string</I
></TT
>, discards the rest, and proceeds to un-escape
characters escaped with '\'.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1778"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>string</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a string</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1783"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>num_chars</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the number of chars to process.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1788"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the unescaped sub string.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1793"
></A
><H3
><A
NAME="BONOBO-MONIKER-CLIENT-EQUAL"
></A
>bonobo_moniker_client_equal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> bonobo_moniker_client_equal (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const <GTKDOCLINK
HREF="CORBA-CHAR"
>CORBA_char</GTKDOCLINK
> *name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *opt_ev);</PRE
></TD
></TR
></TABLE
><P
>Compare a full <TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> with the given <TT
CLASS="PARAMETER"
><I
>name</I
></TT
></P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1806"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> The moniker</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1811"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a display name eg. file:/demo/a.jpeg</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1816"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>opt_ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> optional CORBA_Environment or NULL.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1821"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> TRUE if they are the same</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1826"
></A
><H3
><A
NAME="BONOBO-MONIKER-RESOLVE-ASYNC"
></A
>bonobo_moniker_resolve_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_moniker_resolve_async (<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
<GTKDOCLINK
HREF="BONOBO-RESOLVEOPTIONS"
>Bonobo_ResolveOptions</GTKDOCLINK
> *options,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
>An async version of bonobo_moniker_client_resolve</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1839"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the moniker to resolve</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1844"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>options</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> resolve options</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1849"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1854"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1859"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>timeout_msec</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the timeout in milliseconds </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1864"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the async callback that gets the response </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1869"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> user context data to pass to that callback </P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1874"
></A
><H3
><A
NAME="BONOBO-MONIKER-RESOLVE-ASYNC-DEFAULT"
></A
>bonobo_moniker_resolve_async_default ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void bonobo_moniker_resolve_async_default
(<GTKDOCLINK
HREF="BONOBO-MONIKER"
>Bonobo_Moniker</GTKDOCLINK
> moniker,
const char *interface_name,
<GTKDOCLINK
HREF="CORBA-ENVIRONMENT"
>CORBA_Environment</GTKDOCLINK
> *ev,
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> timeout_msec,
<A
HREF="bonobo-bonobo-moniker-util.html#BONOBOMONIKERASYNCFN"
>BonoboMonikerAsyncFn</A
> cb,
<GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
>An async version of bonobo_moniker_client_resolve_default</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1886"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>moniker</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1891"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interface_name</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the name of the interface we want returned as the result </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1896"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ev</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> a corba exception environment </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1901"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>timeout_msec</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the timeout in milliseconds </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1906"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>cb</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the async callback that gets the response </P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN1911"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> user context data to pass to that callback </P
></TD
></TR
></TBODY
></TABLE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-bonobo-context.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-object-activation.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-object-client.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>bonobo-context</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>BonoboObjectClient</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
PLD
>
ac
>
amd64
>
media
>
dist
>
by-pkgid
>
fd2761970a77896f276e13daf3a9620f
>
files
>
110
