Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DtMmdbDlpGetPrevSectionId(library call)DtMmdbDlpGetPrevSectionId(library call)

NAME
       DtMmdbDlpGetPrevSectionId  -- obtains the object	identifier of the pre-
       vious section

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

DESCRIPTION
       The DtMmdbDlpGetPrevSectionId function returns the object identifier of
       the previous section. You can use this function to traverse the TOC hi-
       erarchy 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  DtMmdbDlpGetPrevSectionId  completes	 successfully,	it  returns  a
       pointer to the object identifier	for the	previous  section  or  DtMmdb-
       GroundId,  if  there is no previous section.  If	it fails, it returns a
       NULL pointer.

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

       DtMmdbInfoRequest request;
       /* fill the request here	*/
       DtMmdbHandle* x = DtMmdbDlpGetPrevSectionId(&request);
       if ( x == DtMMdbGroundId) {
	  /* no	previous section */
       } else
	 {
	  if (x	== 0) {
	    /* bad request */
	 }
	 else
	 { /* make use of x */
	 }

SEE ALSO
       DtMmdbDlpGetNextSectionId(3)

				       DtMmdbDlpGetPrevSectionId(library call)

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DtMmdbDlpGetPrevSectionId&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help