Export (0) Print
Expand All

AtlTrace (Obsolete) (ATL)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Beginning in ATL 7.0, AtlTrace is obsolete. Use ATLTRACE2 instead.

inline void _cdecl AtlTrace(
   LPCSTR lpszFormat,
inline void _cdecl AtlTrace(
   LPCWSTR lpszFormat,


[in] The string and variables to send to the Visual C++ output window or any application that traps these messages.

Sends the specified string to the debugger of the current application. For example:

AtlTrace(_T("The value of x is %d.\n"), x);


AtlTrace can be used in both debug and release builds, but it has no effect in release builds. The call to the function is evaluated, but the function does nothing. In debug builds, the function sends the specified string, after formatting, to the dump device.

AtlTrace limits the contents of the string to be sent to the dump device to no more than 511 characters, after formatting.

© 2014 Microsoft