hpux man page for dtmmdbtocgetchildids

DtMmdbTocGetChildIds(library call)										DtMmdbTocGetChildIds(library call)

NAME
       DtMmdbTocGetChildIds -- obtains a list of object identifiers for child sections

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

DESCRIPTION
       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
       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
       If  DtMmdbTocGetChildIds  completes  successfully,  it  returns	a NULL-terminated object identifier array.  If it fails, it returns a NULL
       pointer.

EXAMPLE
       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
       TO BE SUPPLIED

														DtMmdbTocGetChildIds(library call)