Edit

Share via


/HEAP (Set Heap Size)

/HEAP:reserve[,commit]

Remarks

The /HEAP option sets the size of the heap in bytes. This option is only for use when building an .exe file.

The reserve argument specifies the total heap allocation in virtual memory. The default heap size is 1 MB. The linker rounds up the specified value to the nearest 4 bytes.

The optional commit argument specifies the amount of physical memory to allocate at a time. Committed virtual memory causes space to be reserved in the paging file. A higher commit value saves time when the application needs more heap space, but increases the memory requirements and possibly the startup time.

Specify the reserve and commit values in decimal or C-language notation.

This functionality is also available via a module definition file with HEAPSIZE.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see Set C++ compiler and build properties in Visual Studio.

  2. Select the Configuration Properties > Linker > System property page.

  3. Modify the Heap Commit Size property.

To set this linker option programmatically

See also

MSVC linker reference
MSVC Linker Options