NAME
          DtCnetCharacterGetShapes - Returns a list of shapes that
          belong to a character.

     SYNOPSIS
          #include <Dt.h>

          int  DtCnetCharacterGetShapes( int cnetID, int *count, int **shapelist )

     DESCRIPTION
          DtCnetCharacterGetShapes() returns the number of shapes and
          the list of shapes of a MetaCycle character denoted by
          cnetID, via the pointers to the count parameter and the
          shapelist parameter. The value returned in count will be the
          size of the array of integer shape ID's in shapelist. The
          memory returned by shapelist should not be deallocated by
          the caller. Deallocation is handled internally by the Dt
          layer.


     IMPLEMENTATION NOTES
          This function uses the set name of a shape to identify what
          character it belongs to. A shape may have its own set name,
          as well as a different set name for its parent. In these
          cases, the parent name will be used to determine set
          membership of a shape in a character. If the parent has not
          been exported to the translator, the shape's original set
          name will be used. Note that it is possible that all the
          shapes returned may have a parent. To identify the top-most
          shape in a character, you should check and see if the set of
          the parent of any returned shape is NULL or not equal to the
          set of the child (use DtShapeGetSetName() ).


     DIAGNOSTICS
          DtCnetCharacterGetShapes() returns one on success and zero
          on failure.


     FILES
          Link with -lDtOMio