MrmCloseHierarchy(library call)             MrmCloseHierarchy(library call)




 NAME    [Toc]    [Back]
      MrmCloseHierarchy - Closes a UID hierarchy

 SYNOPSIS    [Toc]    [Back]
      #include <Mrm/MrmPublic.h>
      Cardinal MrmCloseHierarchy(
      MrmHierarchy hierarchy_id);

 DESCRIPTION    [Toc]    [Back]
      The MrmCloseHierarchy function closes a UID hierarchy previously
      opened by MrmOpenHierarchyPerDisplay.  All files associated with the
      hierarchy are closed by the Motif Resource Manager (MRM) and all
      associated memory is returned.

      hierarchy_id
                Specifies the ID of a previously opened UID hierarchy.  The
                hierarchy_id was returned in a previous call to
                MrmOpenHierarchyPerDisplay.

 RETURN    [Toc]    [Back]
      This function returns one of the following status return constants:

      MrmSUCCESS    [Toc]    [Back]
                The function executed successfully.

      MrmBAD_HIERARCHY    [Toc]    [Back]
                The hierarchy ID was invalid.

      MrmFAILURE    [Toc]    [Back]
                The function failed.

 RELATED    [Toc]    [Back]
      MrmOpenHierarchyPerDisplay(3).


                                    - 1 -       Formatted:  January 24, 2005