DtMmdbLocatorGetSectionLoc(library calDtMmdbLocatorGetSectionLoc(library call)NAMEDtMmdbLocatorGetSectionLoc — obtains the locator of a section
SYNOPSIS
#include <DtMmdb.h>
const char* DtMmdbLocatorGetSectionLoc(
DtMmdbInfoRequest* request);
DESCRIPTION
The DtMmdbLocatorGetSectionLoc function returns the locator of the sec‐
tion that contains the specified component. Do not use the free func‐
tion on the returned pointer. Table lookup is involved because the com‐
ponent identifier is specified by the locator_ptr field.
ARGUMENTS
request Specifies the bookcase in the bookcase descriptor field and
the identifier of a component within the section in the loca‐
tor_ptr field.
RETURN VALUE
If DtMmdbLocatorGetSectionLoc completes successfully, it returns a
pointer to the section locator. If it fails, it returns a NULL pointer.
EXAMPLE
The following shows how a DtMmdbLocatorGetSectionLoc call might be
coded.
DtMmdbInfoRequest request;
/* fill the request */
DtMmdbLocatorGetSectionLoc(&request);
SEE ALSO
TO BE SUPPLIED
DtMmdbLocatorGetSectionLoc(library call)