hpux man page for dtmmdbgetbookcasebylocs

DtMmdbGetBookCaseByLocs(library call)									     DtMmdbGetBookCaseByLocs(library call)

NAME
       DtMmdbGetBookCaseByLocs -- obtains descriptors for a set of bookcases based on hypertext link targets

SYNOPSIS
       #include <DtMmdb.h>
       int DtMmdbGetBookCaseByLocs(
       int infolib_descriptor,
       const char** locators);

DESCRIPTION
       The  DtMmdbGetBookCaseByLocs  function  makes  the database engine ready to provide access service for a set of bookcases. It allows you to
       access multiple bookcases by specifying hypertext link targets that occur within the bookcases.	Use the free function to release the array
       of bookcase descriptors when it is no longer needed.

ARGUMENTS
       infolib_path
		 Specifies the infolib that contains the bookcase.

       locators  Specifies  a  zero-terminated	array  of locators of hypertext link targets. Each target can be a section or a component within a
		 section.

RETURN VALUE
       If DtMmdbGetBookCaseByLocs completes successfully, it returns a pointer to a NULL-terminated array of bookcase descriptors. If it fails, it
       returns NULL.

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

       char locs[] = {"abcde0123456789", "fghij0123456789", 0 };
       int* descriptor_array = DtMmdbGetBookCaseByLocs(myInfoLibDescriptor,  locs);

SEE ALSO
       DtMmdbGetBookCaseByIndex(3), DtMmdbGetBookCaseByLoc(3), DtMmdbGetBookCaseByName(3)

													     DtMmdbGetBookCaseByLocs(library call)