AtlTrace (Obsolete) (ATL)

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

inline void _cdecl AtlTrace( 
   LPCSTR lpszFormat, 
   ... 
); 
inline void _cdecl AtlTrace( 
   LPCWSTR lpszFormat, 
   ... 
);

Parameters

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

Remarks

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

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

Note

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.

See Also

Reference

ATLTRACE (ATL)

Obsolete ATL Topics

Other Resources

Debugging and Error Reporting Global Functions