DtMmdbTocGetChildIds(library call)       DtMmdbTocGetChildIds(library call)




 NAME    [Toc]    [Back]
      DtMmdbTocGetChildIds - obtains a list of object identifiers for child
      sections

 SYNOPSIS    [Toc]    [Back]
      #include <DtMmdb.h>
      DtMmdbHandle** DtMmdbTocGetChildIds(
      DtMmdbInfoRequest* request,
      unsigned int* length);

 DESCRIPTION    [Toc]    [Back]
      The DtMmdbTocGetChildIds function returns an array of the object
      identifiers for the child sections belonging to the specified section.
      Use the DtmmdbFreeHandleList to release the array when it is no longer
      needed.

 ARGUMENTS    [Toc]    [Back]
      request   Specifies the bookcase in the bookcase descriptor field and
                the section's Database Engine identifier, in the primary_oid
                field.

      length    Specifies the variable to receive the length of the returned
                array (in bytes), if the returned pointer to the array is
                not NULL. If it is set to zero, the section has no child
                section.

 RETURN VALUE    [Toc]    [Back]
      If DtMmdbTocGetChildIds completes successfully, it returns a NULLterminated
 object identifier array.  If it fails, it returns a NULL
      pointer.

 EXAMPLE    [Toc]    [Back]
      The following shows how a DtMmdbTocGetChildIds call might be coded.

      DtMmdbInfoRequest request; unsigned int length;
      /* fill the request here */
      handleList = DtMmdbTocGetChildIds(&request, &length);

 SEE ALSO    [Toc]    [Back]
      TO BE SUPPLIED


                                    - 1 -       Formatted:  January 24, 2005