DtMmdbGraphicGetData(library call) DtMmdbGraphicGetData(library call)
NAME [Toc] [Back]
DtMmdbGraphicGetData - obtains the data for a graphic object
SYNOPSIS [Toc] [Back]
#include <DtMmdb.h>
const char* DtMmdbGraphicGetData(
DtMmdbInfoRequest* request,
unsigned int* length);
DESCRIPTION [Toc] [Back]
The DtMmdbGraphicGetData function returns the data for a graphic
object. Do not use the free function on the returned pointer. Table
lookup is involved because the graphic identifier is specified by the
locator_ptr field.
ARGUMENTS [Toc] [Back]
request Specifies the bookcase in the bookcase descriptor field and
the identifier of the graphic object in the locator_ptr
field.
length Specifies the variable to receive the length of the returned
data, if the returned pointer to the title is not NULL.
RETURN VALUE [Toc] [Back]
If DtMmdbGraphicGetData completes successfully, it returns a pointer
to the data for the graphic object. If it fails, it returns a NULL
pointer.
EXAMPLE [Toc] [Back]
The following shows how a DtMmdbGraphicGetData call might be coded.
DtMmdbInfoRequest request;
/* fill the request */
DtMmdbGraphicGetData(&request);
SEE ALSO [Toc] [Back]
TO BE SUPPLIED
- 1 - Formatted: January 24, 2005 [ Back ] |
