[Contents] [Index] [Next] [Previous]

MrmCloseHierarchy


NAME

MrmCloseHierarchy - Closes a UID hierarchy

SYNOPSIS

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

DESCRIPTION

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 VALUE

This function returns one of these status return constants:

MrmSUCCESS
The function executed successfully.
MrmBAD_HIERARCHY
The hierarchy ID was invalid.
MrmFAILURE
The function failed.

RELATED INFORMATION

MrmOpenHierarchyPerDisplay(3X).