hpux man page for dtmmdbtocgetparentid

DtMmdbTocGetParentId(library call)										DtMmdbTocGetParentId(library call)

NAME
       DtMmdbTocGetParentId -- obtains the object identifier of the parent section

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

DESCRIPTION
       The DtMmdbTocGetParentId function returns the object identifier of the section that is parent to the specified section. Use the DtMmdbFree-
       Handle to release the identifier 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.

RETURN VALUE
       If DtMmdbTocGetParentId completes successfully, it returns the object identifier of the parent section.	If it fails,  it  returns  a  NULL
       pointer.

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

       DtMmdbInfoRequest request;
       /* fill the request here */
       DtMmdbHandle* parent = DtMmdbTocGetParentId(&request);
       if  (parent != DtMmdbGroundId) {
	  if (parent == 0) {
	      /* invalid request */
	  } else {
	    /* parent points at the parent section */
	  }
       } else { /* this section is the root section */
	}

SEE ALSO
       TO BE SUPPLIED

														DtMmdbTocGetParentId(library call)