DLI Implementation and Reference Guide - Datalogics

A.46 DLI Reference Guide
dlpdfdocdestroy (DLPDFDOC *Doc)
Return Value: void
Concepts and Facilities: Guide to the DL Pager Composition System
Description
Parameters
Return Value
Destroys the specified document, releasing all
resources used in the document.
DLPDFDOC *Doc: represents the document
structure and the current status of the document
at all times.
void
Exceptions
Header
Related Methods
Availability
dli.h
dlpdfdoccreate,
dlpdfinstancesetgrcachelimits
All DLI-supported platforms.
Technical Notes
1 All documents should be destroyed before terminating DLI.
2 A pointer to a DLPDFDOC structure is invalid and should not be used after calling
dlpdfdocdestroy for that structure.
3 The collection of information regarding where elements lie within a document is
the responsibility of the composition engine. DLI cannot provide assistance with
this.
4 If dlpdfinstancesetgrcachelimits had been set previously, the graphics
cache size is evaluated at this time, and graphics are purged if the cache size
exceeds its preset high-water mark limit.
5 If applicable, dlpdfdocdestroy removes the Files In Memory file representing
the DLI document if no handle has been acquired to the file in memory.