DtMmdbGetBookCaseByLocs(library call) DtMmdbGetBookCaseByLocs(library call)
NAMEDtMmdbGetBookCaseByLocs — 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 ALSODtMmdbGetBookCaseByIndex(3), DtMmdbGetBookCaseByLoc(3), DtMmdbGetBook‐
CaseByName(3)
DtMmdbGetBookCaseByLocs(library call)