How heapwalk() Checks the Heap

MS-DOS                           | OS/2            | WINDOWS

The information in this article applies to:

• The C Run-time (CRT), included with:

      - Microsoft C for MS-DOS, versions 5.0, 5.1, 6.0, 6.0a, and 6.0ax
      - Microsoft C for OS/2, versions 5.1, 6.0, and 6.0a
      - Microsoft C/C++ for MS-DOS, version 7.0
      - Microsoft Visual C++ for Windows, version 1.0
  

The heapwalk() function traverses one element of the heap each time it is called. To traverse the entire heap, an application must call the heapwalk() function repeatedly. Each heapwalk() call places information about one block of memory into the fields of a _HEAPINFO structure, the address of which is specified by the calling application. The _HEAPINFO structure contains the address of the memory block, the size of the block, and a flag to indicate that the block is free or in use. In addition, the function returns an integer that corresponds to one of six predefined constants. For more information, please refer to the Microsoft C "Run-Time Library Reference" manual.