NAME
       GetObjectMaximum -- get the maximum number of instances for a given Blitz
                           object

   SYNOPSIS
       maximum = GetObjectMaximum(xtraFile, libNum);
       D0                         A0        D0:16

       WORD maximum = GetObjectMaximum(struct BlitzXtra * xtraFile, UWORD libNum);

   FUNCTION
       Each blitz library can have an associated 'object'. When compiling programs,
       it is necessary for the compiler to allocate a fixed size object buffer. To
       achieve this, a user-definable limit is set on the number of instances that
       can be created for any given object. This information is stored in the
       Blitz .xtra file. This function, when passed a valid library number and
       BlitzXtra structure can return the maximum instances for the library's
       associated object.

   INPUTS
       xtraFile - a pointer to a valid BlitzXtra structure, as returned by a call
                  to either  AllocXtra() or  LoadXtra()

       libNum   - the library's identification number

   RESULT
       maximum - the maximum number of instances that can be created for the
                 library's associated object (-1 indicated that no object
                 is associated with the given library)

   SEE ALSO
        GetObjectName(),  AllocXtra(),  LoadXtra(), <libraries/blitz.h>,
       <libraries/blitz.i>