Sentry Spelling Checker Engine - Support |
Home Site index Contact us Catalog Shopping Cart Products Support Search |
You are here: Home > Support > Sentry Spelling Checker Engine > How to enable the diagnostic log file
Product: Sentry Spelling Checker Engine Windows SDK
Description: The Sentry Windows DLL records certain information in a diagnostic log file, particularly information about errors and failures. Often, this information is very helpful in diagnosing the causes of specific problems, such as failure to open dictionaries or error returns from function calls. The diagnostic log file must be enabled or it will not be created. This document describes how to enable the log file.
The log file contains plain, ASCII text, and can be examined using a program such as NotePad. By examining the file, you may be able to diagnose and solve the problem on your own. If not, you can send the contents of the log file to Wintertree Software's Support group for help.
Instructions:
If you let the Sentry DLL reads its properties from the system registry (which is the default), define DebugFile as a string value in the registry. If your application does not call SSCE_SetRegTreeName, define DebugFile under HKEY_CURRENT_USER\Software\Wintertree\SSCE; otherwise, define DebugFile under the registry tree used by your application.
If you tell the Sentry DLL to read its properties from an INI file, add the DebugFile property under the [SSCE User] heading.
Set DebugFile to the full, absolute path to a file on your system. Do not specify a relative path (i.e., the path should begin with "c:\", "d:\", etc.). The file and folder containing it must be writable by the calling application. The file does not need to exist in the folder; the Sentry DLL will create it if necessary. However, the folder itself, and the path to the folder, must exist.
A good place for the diagnostic log file is a folder where other writable files used by your application are contained.
Example DebugFile setting:
c:\Program Files\myapp\data\sentrydebug.txt
Copyright © 2015 Wintertree Software Inc.