DEBUGCHK

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

DEBUGMSG
ERRORMSG
RETAILMSG