RETAILMSG

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This macro conditionally outputs a printf-style formatted message.


RETAILMSG (
    Expression,
    Message
) 

Expression

Boolean expression used to determine if the message would be output.

Message

Expression to be printed using printf format style.

The printf-style message parameter is output if the Boolean input expression evaluates to TRUE. Note that the parameter Message must be enclosed by parentheses to prevent syntax errors being generated by the preprocessor. This macro should be used sparingly, as it increases the size of retail builds.

 RETAILMSG(TRUE, (TEXT("Testing item count against maximum %u\r\n"),
         dwMaxNumberOfItems));
 RETAILMSG(dwCurrentNumberOfItems >= dwMaxNumberOfItems,
          (TEXT("Invalid item count! Found %u, expected less than %u\r\n"),
           dwCurrentNumberOfItems, dwMaxNumberOfItems));

Output:

 Testing item count against maximum 68
 Invalid item count! Found 343, expected less than 68

Headerdbgapi.h
Windows Embedded CEWindows CE 2.10 and later
Windows MobileWindows Mobile Version 5.0 and later
Show: