Merge pull request MicrosoftDocs#4658 from mspll/patch-1

largeaddressaware:no is not recommended for 64-bit apps

Author: Court72

docs/build/reference/largeaddressaware-handle-large-addresses.md

@@ -1,10 +1,9 @@
 ---
 description: "Learn more about: /LARGEADDRESSAWARE (Handle Large Addresses)"
 title: "/LARGEADDRESSAWARE (Handle Large Addresses)"
-ms.date: "11/04/2016"
+ms.date: "02/12/2024"
 f1_keywords: ["VC.Project.VCLinkerTool.LargeAddressAware", "/largeaddressaware"]
 helpviewer_keywords: ["LARGEADDRESSAWARE linker option", "-LARGEADDRESSAWARE linker option", "/LARGEADDRESSAWARE linker option"]
-ms.assetid: a29756c8-e893-47a9-9750-1f0d25359385
 ---
 # /LARGEADDRESSAWARE (Handle Large Addresses)
 
@@ -14,9 +13,11 @@ ms.assetid: a29756c8-e893-47a9-9750-1f0d25359385
 
 ## Remarks
 
-The /LARGEADDRESSAWARE option tells the linker that the application can handle addresses larger than 2 gigabytes. In the 64-bit compilers, this option is enabled by default. In the 32-bit compilers, /LARGEADDRESSAWARE:NO is enabled if /LARGEADDRESSAWARE is not otherwise specified on the linker line.
+The /LARGEADDRESSAWARE option tells the linker that the application can handle addresses larger than 2 gigabytes. In the 64-bit compilers, this option is enabled by default. In the 32-bit compilers, `/LARGEADDRESSAWARE:NO` is enabled if `/LARGEADDRESSAWARE` is not otherwise specified on the linker line.
 
-If an application was linked with /LARGEADDRESSAWARE, DUMPBIN [/HEADERS](headers.md) will display information to that effect.
+If an application was linked with `/LARGEADDRESSAWARE`, `DUMPBIN` [/HEADERS](headers.md) will display information to that effect.
+
+Linking 64-bit applications with **`/LARGEADDRESSAWARE:NO`** is not recommended because it restricts the available address space, which can result in runtime failures if the app exhausts memory. It may also prevent x64 apps from running on ARM64 systems because the emulation runtime will try to reserve 4GB of virtual address space. If the app was linked with `/LARGEADRESSAWARE:NO`, the app won't launch because it can't allocate that much address space.
 
 ### To set this linker option in the Visual Studio development environment