*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtMmdbDlpGetNextSectionId (3)              


 DtMmdbDlpGetNextSectionId(library calDlt)MmdbDlpGetNextSectionId(library call)

 NAME    [Toc]    [Back]
      DtMmdbDlpGetNextSectionId - obtains the object identifier of the next

 SYNOPSIS    [Toc]    [Back]
      #include <DtMmdb.h>
      DtMmdbHandle* DtMmdbDlpGetNextSectionId(
      DtMmdbInfoRequest* request);

 DESCRIPTION    [Toc]    [Back]
      The DtMmdbDlpGetNextSectionId function returns the object identifier
      of the next section. You can use this function to traverse the TOC
      hierarchy in a depth-first fashion.

      Use the DtMmdbFreeHandleList function to release the memory when the
      object identifier is no longer needed. Table lookup is involved.

 ARGUMENTS    [Toc]    [Back]
      request   Specifies the bookcase in the bookcase descriptor field, as
                well as the id of the current section in the primary_oid

 RETURN VALUE    [Toc]    [Back]
      If DtMmdbDlpGetNextSectionId completes successfully, it returns a
      pointer to the object identifier for the next section or
      DtMmdbGroundId, if there is no next section.  If it fails, it returns
      a NULL pointer.

 EXAMPLE    [Toc]    [Back]
      The following shows how a DtMmdbDlpGetNextSectionId call might be

      DtMmdbHandle* my_oid;
      DtMmdbInfoRequest request;
      request.bookcase_descriptor = DtMmdbGetBookCase(myInfoLibPtr, "myBase");
      request.primary_oid = my_oid;
      DtMmdbHandle* x = DtMmdbDlpGetNextSectionId(&request);
      if ( x == DtMMdbGroundId) {
         /* no next section */
      } else
         if (x == 0) {
           /* bad request */
        { /* make use of x */

 SEE ALSO    [Toc]    [Back]

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
DtMmdbLocatorGetSectionObjectId HP-UX obtains the object identifier of a section
DtMmdbTocGetParentId HP-UX obtains the object identifier of the parent section
DtMmdbDlpGetPrevSectionId HP-UX obtains the object identifier of the previous section
DtMmdbSectionGetBookId HP-UX obtains the object identifier of a book
DtMmdbSectionGetStyleSheetId HP-UX obtains the object identifier of a section's stylesheet
DtMmdbSectionGetData HP-UX obtains the data for a section
DtMmdbLocatorGetSectionLoc HP-UX obtains the locator of a section
DtMmdbSectionGetShortTitle HP-UX obtains the short title for a section
DtMmdbSectionGetTocLoc HP-UX obtains the locator for a book's TOC section
DtMmdbBookGetTocObjectId HP-UX obtains the locator of a book's TOC section
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service