MrmCloseHierarchy(3X)

     NAME
          MrmCloseHierarchy - Closes a UID hierarchy

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          The MrmCloseHierarchyfunction 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
          This function returns one of the following status return
          constants:

          MrmSUCCESS
                    The function executed successfully.

          MrmBAD_HIERARCHY
                    The hierarchy ID was invalid.

          MrmFAILURE
                    The function failed.

     RELATED
          MrmOpenHierarchyPerDisplay(3).