DLI Implementation and Reference Guide - Datalogics

Error Testing and Recovery 16.5
DLExceptionMessage
Returns: char*
DLExceptionMessage returns a non-NULL pointer if an additional message string
was generated by Adobe PDF Library or DLI when an exception was raised. This
pointer may be NULL when an error is raised if the Adobe PDF Library or DLI
function does not supply the optional message string.
The application should call DLExceptionFlag after each Adobe PDF Library and
DLI function call to determine if an exception was raised. If the flag is non-zero, the
application should use DLExceptionCode and/or DLExceptionMessage to
obtain additional information, then handle the exception as appropriate.
These are the basic steps that should be followed:
1 Call the desired Adobe PDF Library/DLI function
2 Get the Exception Status by calling DLExceptionFlag
3 If DLExceptionFlag returns a non-zero value:
• Get additional error information (DLExceptionCode, ASGetErrorString,
DLExceptionFlag)
• Handle exception as appropriate to the application (e.g. switch to a default font,
flush the current statement, etc.).