Useful notes about debugging CSDK integration

• Most of the error codes are large negative numbers, less than -32768, and Visual Studio is not able to show their symbolic value when User places the mouse pointer over a RECERR variable. The function watch_recerr can be used for displaying this symbolic value in a Watch window.

• When loading PDF files OmniPage CSDK periodically throws a PDF_PROGRESS C++ Exception. Unwanted debugger breaks can be avoided by switching this exception off inside the debugger's exception handlig. For example in Visual Studio the following steps are required:
  1. In Debug->Exceptions... menu there is an Exceptions dialog box.
  2. Click Add... button.
  3. Select type C++ Exceptions.
  4. Enter the name PDF_PROGRESS.
  5. Click OK.
  6. Under C++ Exceptions - PDF_PROGRESS leave the Thrown checkbox unchecked.