ASSERTMSG (Windows CE 5.0)
This macro asserts an expression, and if that expression is FALSE, it prints a debugging message to NKDbgPrintfW and produces a DebugBreak.
#defineASSERTMSG(message,Condition)
Parameters
- Message
Formatted debugging message. - Condition
Boolean value used to determine whether DEBUGMSG and DEBUGCHK are invoked.
Return Values
None.
Remarks
This macro may be used to check the value of a Boolean expression and produce a formatted text message, as well as generating a DebugBreak if the expression evaluates FALSE.
If the expression evaluates to FALSE, this code will print your failure message and then DebugBreak to allow you to examine the situation in a debugger. 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:
ASSERTMSG(TEXT("Invalid number of items"),
dwCurrentNumberOfItems < dwMaxNumberOfItems);
Will print output like this:
Invalid number of items
Unknown: DEBUGCHK failed in file C:\WINCE500\Programs\MyProgram\.\main.c at line 34
This macro is only present in Debug builds; it does nothing on Retail and ship builds.
To evaluate an assertion without printing an additional message, use ASSERT.
Requirements
OS Versions: Windows CE OS 2.10 and later
Header: Dbgapi.h
Link Library: none
See Also
ASSERT | DEBUGMSG | DebugBreak
Send Feedback on this topic to the authors