NAME    [Toc]    [Back]

       MrmRegisterNames  -  Registers  the values associated with
       the names referenced in UIL  (for  example,  UIL  callback
       function names or UIL identifier names)

SYNOPSIS    [Toc]    [Back]

       #include <Mrm/MrmPublic.h>

       Cardinal MrmRegisterNames(register_list, register_count)
               MrmRegisterArglist register_list;
               MrmCount register_count;

DESCRIPTION    [Toc]    [Back]

       The  MrmRegisterNames function registers a vector of names
       and associated values for access in MRM. The values can be
       callback  functions, pointers to user-defined data, or any
       other values. The information provided is used to  resolve
       symbolic  references  occurring in UID files to their runtime
 values.  For callbacks, this information provides the
       procedure address required by the Motif Toolkit. For names
       used as identifiers in UIL, this information provides  any
       run-time mapping the application needs.

       This  function  is similar to MrmRegisterNamesInHierarchy,
       except that the scope of the names registered by MrmRegisterNamesInHierarchy
  is limited to the hierarchy specified
       in the call to that function, whereas the names registered
       by MrmRegisterNames have global scope. When MRM looks up a
       name, it first tries to find the name among  those  registered
  for  the  given hierarchy. If that lookup fails, it
       tries to find the name among  those  registered  globally.
       Specifies  a  list of name/value pairs for the names to be
       registered.  Each name is  a  case-sensitive,  NULL-terminated
  ASCII  string.  Each  value  is  a 32-bit quantity,
       interpreted as a procedure address if the name is a  callback
 function, and uninterpreted otherwise.  Specifies the
       number of entries in register_list.

       The names in the list are case-sensitive. The list can  be
       either ordered or unordered.

       Callback functions registered through MrmRegisterNames can
       be either regular or creation callbacks. Regular callbacks
       have  declarations  determined  by  Motif Toolkit and user
       requirements. Creation callbacks have the same  format  as
       any other callback:

       void CallBackProc(widget_id, tag, callback_data)
               Widget *widget_id;
               Opaque tag
               XmAnyCallbackStruct *callback_data;

       Specifies  the  widget  ID associated with the widget performing
 the callback (as in any callback function).  Specifies
 the tag value (as in any callback function).  Specifies
 a widget-specific data structure. This data structure
       has a minimum of two members: event and reason. The reason
       member is always set to MrmCR_CREATE.

       Note that the widget name and parent  are  available  from
       the widget record accessible through widget_id.

RETURN VALUE    [Toc]    [Back]

       This  function  returns  one  of  these status return constants:
 The function executed successfully.  The  function
       failed.



                                             MrmRegisterNames(3X)