DEBUGCHK
A version of this page is also available for
4/8/2010
This macro asserts an expression and produces a DebugBreak if the expression is FALSE.
Syntax
DEBUGCHK (Expression)
Parameters
- Expression
Boolean value that determines when DebugBreak is called.
Return Value
None.
Remarks
This macro may be used to check the value of a Boolean expression and produce a DebugBreak if the expression evaluates FALSE. This macro also prints a debug message with the file name and line number where the assertion failed.
Call this macro to validate invariants in your code. For example:
DEBUGCHK(dwCurrentNumberOfItems < dwMaxNumberOfItems);
Will print output like this:
MyProgram: DEBUGCHK failed in file C:\WINCE500\Programs\MyProgram\.\main.c at line 31
This assertion is only present in Debug builds; it does nothing on Retail and Ship builds.
Calling DEBUGCHK assumes that a global variable dpCurSettings has already been defined, where dpCurSettings must be a DBGPARAMstructure. Use ASSERT within modules that do not define dpCurSettings.
Requirements
| Header | dbgapi.h |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |