Syntax:
void LlSetDebug (INT nOnOff);
Task:
Switches the debug mode on or off.
Parameter:
nOnOff: 0 if debug mode is to be switched off, otherwise the following values can be additionally passed:
|
Value |
Meaning |
|
LL_DEBUG_CMBTLL |
to switch on normal debugging- info |
|
LL_DEBUG_CMBTDWG |
to switch on debugging-info for graphic functions |
|
LL_DEBUG_CMBTLL_NOCALLBACKS |
switch off debugging-info for notifications/callbacks |
|
LL_DEBUG_CMBTLL_NOSTORAGE |
switch off debugging-info for storage- (LlStgSys...()-) functions |
|
LL_DEBUG_CMBTLL_NOSYSINFO |
do not issue system information dump on LlSetDebug() |
|
LL_DEBUG_CMBTLL_LOGTOFILE |
debug output will also be directed to a log file (COMBIT.LOG in your %APPDATA% directory). This path can be determined via LL_OPTIONSTR_LOGFILEPATH. |
Hints:
Use the provided program Debwin to show the debug output.
If debug mode is switched on in List & Label with LlSetDebug(LL_DEBUG_CMBTLL), the DLL prints every function call with the corresponding parameters and results. An '@' is added to the function names, so that the function calls can be easily differentiated from other internal List & Label debugging output.
The output is indented in case a DLL in debugging mode calls other functions of a DLL (even itself) which is also in debugging mode.
Further information can be found in chapter Debug Tool Debwin.
Example:
HLLJOB hJob;
int
v;
LlSetDebug(LL_DEBUG_CMBTLL | ...);
hJob =
LlJobOpen(0);
v = LlGetVersion(VERSION_MAJOR);
LlJobClose(hJob);
prints approx. the following in the debugging output:
@LlJobOpen(0) = 1
@LlGetVersion(1) =
6
@LlJobClose(1)