AfxCheckMemory
This function validates the free memory pool and prints error messages as required.
BOOL AfxCheckMemory( );
Return Value
Nonzero if no memory errors; otherwise 0.
Remarks
If the function detects no memory corruption, it prints nothing.
All memory blocks currently allocated on the heap are checked, including those allocated by new but not those allocated by direct calls to underlying memory allocators, such as the malloc function or the GlobalAlloc Windows function. If any block is found to be corrupted, a message is printed to the debugger output.
If you include the line
#define new DEBUG_NEW
in a program module, then subsequent calls to AfxCheckMemory show the filename and line number where the memory was allocated.
Notes
If your module contains one or more implementations of serializable classes, then you must put the #define line after the last IMPLEMENT_SERIAL macro call.
This function works only in the Debug version of MFC.
Example
CAge* pcage = new CAge(21); // CAge is derived from CObject.
Age* page = new Age(22); // Age is NOT derived from CObject.
*(((char*)pcage) - 1) = 99; // Corrupt preceding guard byte
*(((char*)page) - 1) = 99; // Corrupt preceding guard byte
AfxCheckMemory();
Requirements
Header: afx.h