DtMmdbGetBookCaseByLocs(library call) DtMmdbGetBookCaseByLocs(library call)
NAME [Toc] [Back]
DtMmdbGetBookCaseByLocs - obtains descriptors for a set of bookcases
based on hypertext link targets
SYNOPSIS [Toc] [Back]
#include <DtMmdb.h>
int DtMmdbGetBookCaseByLocs(
int infolib_descriptor,
const char** locators);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
If DtMmdbGetBookCaseByLocs completes successfully, it returns a
pointer to a NULL-terminated array of bookcase descriptors. If it
fails, it returns NULL.
EXAMPLE [Toc] [Back]
The following shows how a DtMmdbGetBookCaseByLocs call might be coded.
char locs[] = {"abcde0123456789", "fghij0123456789", 0 };
int* descriptor_array = DtMmdbGetBookCaseByLocs(myInfoLibDescriptor, locs);
SEE ALSO [Toc] [Back]
DtMmdbGetBookCaseByIndex(3), DtMmdbGetBookCaseByLoc(3),
DtMmdbGetBookCaseByName(3)
- 1 - Formatted: January 24, 2005 [ Back ] |
