Microsoft Windows CE 3.0  

DbgAssert

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.

Handles an assertion failure in a debug build. DbgAssertwill display a message box that includes the condition text, source file name, and source line number. The user will be given the choice to ignore the assertion failure, debug the assertion, or force the application to exit. Thus DbgAssertmight return to the caller, depending on the user's actions.

void WINAPI DbgAssert(
const TCHAR *
pCondition
,
const TCHAR *
pFileName
,
INT iLine);

Parameters

pCondition
Pointer to a string version of a Boolean expression.
pFileName
Pointer to a source file name.
iLine
Line number within the source file.

Remarks

This function is available only in a debug build. Usually, DbgAssertwill be called by macros such as ASSERT, not directly from other code.

If you use the ASSERTmacro, DbgAssertmight display a message box. If this is not acceptable in your environment, you can use DbgKernelAssertinstead.