Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro asserts an expression and produces a DebugBreakif the expression is FALSE.

Syntax 

DEBUGCHK (
Expression)

Parameters

Expression

Boolean value that determines when DebugBreakis called.

Return Value

None.

Remarks

This macro may be used to check the value of a Boolean expression and produce a DebugBreakif 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:

Copy Code 
 DEBUGCHK(dwCurrentNumberOfItems < dwMaxNumberOfItems);

Will print output like this:

Copy Code 
 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 DEBUGCHKassumes that a global variable dpCurSettingshas already been defined, where dpCurSettingsmust be a DBGPARAMstructure. Use ASSERTwithin 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

See Also