Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DtMmdbDlpGetNextSectionId(library call)DtMmdbDlpGetNextSectionId(library call)

NAME
       DtMmdbDlpGetNextSectionId  —  obtains the object identifier of the next
       section

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

DESCRIPTION
       The DtMmdbDlpGetNextSectionId function returns the object identifier of
       the next section. You can use this function to traverse the TOC hierar‐
       chy 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
       request	 Specifies  the	 bookcase in the bookcase descriptor field, as
		 well as the id of the	current	 section  in  the  primary_oid
		 field.

RETURN VALUE
       If  DtMmdbDlpGetNextSectionId  completes	 successfully,	it  returns  a
       pointer to the object identifier for the next section  or  DtMmdbGroun‐
       dId,  if	 there	is  no	next  section.	If it fails, it returns a NULL
       pointer.

EXAMPLE
       The following shows  how	 a  DtMmdbDlpGetNextSectionId  call  might  be
       coded.

       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 */
	 }
	 else
	 { /* make use of x */
	 }

SEE ALSO
       DtMmdbDlpGetPrevSectionId(3)

				       DtMmdbDlpGetNextSectionId(library call)

Vote for polarhome