DLI Implementation and Reference Guide - Datalogics

16.4 DLI Implementation and Reference Guide
to return the value X, or the E_RTRN_VOID macro to exit a function with no return
value.
Concepts and Facilities: Guide to the DL Pager Composition System
OS/390 Platform Concerns
The preceding error recovery mechanism applies on the OS/390 platform if the SAS/C
compiler is used. In cases where the OS/390 application is not compiled via SAS/C, it
must use a different mechanism to obtain the error status. This consists of three
primary function calls:
DLExceptionFlag
Returns: ASInt32
DLExceptionFlag returns 0 if no exception was raised by the exception handler in
the most-recently-called Adobe PDF Library or DLI function. A non-zero return
value indicates that an error was detected while processing the last function call.
This error mechanism is destructive, in that the flag value is reset by accessing it with
the DLExceptionFlag function call.
NOTE: If DLExceptionFlag returns a non-zero return code, the return value
of the function in which the error occurred is undefined.
DLExceptionCode
Returns: ASInt32
DLExceptionCode returns the last exception code set by an exception raised by an
Adobe PDF Library or DLI function. The code value returned by the
DLExceptionCode function may be used to retrieve an error message via a call to
ASGetErrorString, as documented in the Adobe PDF Library Developer Guide.