Add "Remarks" and "Example" headings for error references in range [C1211, C1800]

Rageking8 · web-flow · commit cd10305295cf · 2025-07-06T21:50:15.000+08:00
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md
@@ -10,6 +10,8 @@ ms.assetid: df0ca70d-ec6e-4400-926a-b877e2599978
 
 > The TypeForwardedTo Custom Attribute is not supported by the version of the runtime installed
 
+## Remarks
+
 C1211 occurs when you have a compiler for the current release, but a common language runtime from a previous release.
 
 Some functionality of the compiler may not work on a previous version of the run time.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md
@@ -10,6 +10,8 @@ ms.assetid: 1629c850-e2db-4678-83d8-9bfc85323bc5
 
 > profile database 'pgd_file' is for a different architecture
 
+## Remarks
+
 A .pgd file that was generated from the /LTCG:PGINSTRUMENT operation for another platform was passed to [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md) . [Profile-guided optimizations](../../build/profile-guided-optimizations.md) are available for x86 and x64 platforms. However, a .pgd file generated with a /LTCG:PGINSTRUMENT operation for one platform is not valid as input to a /LTCG:PGOPTIMIZE for a different platform.
 
 To resolve this error, only pass a .pgd file that is created with /LTCG:PGINSTRUMENT to /LTCG:PGOPTIMIZE on the same platform.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md
@@ -10,6 +10,8 @@ ms.assetid: 6f77d3d4-ba8a-476c-b540-aff19eb4efc4
 
 > program has been edited since profile data was collected
 
+## Remarks
+
 When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the linker detected an input module that was recompiled after /LTCG:PGINSTRUMENT and that the module was changed to the point where existing profile data is no longer relevant. For example, if the call graph changed in the recompiled module, the compiler will generate C1307.
 
 To resolve this error, run /LTCG:PGINSTRUMENT, redo all test runs, and run /LTCG:PGOPTIMIZE. If you cannot run /LTCG:PGINSTRUMENT and redo all test runs, use /LTCG:PGUPDATE instead of /LTCG:PGOPTIMIZE to create the optimized image.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md
@@ -10,10 +10,14 @@ ms.assetid: 46177997-069e-433a-8e20-93c846d78ffd
 
 > linking assemblies is not supported
 
+## Remarks
+
 A .netmodule is allowed as input to the linker, but an assembly is not. This error can be generated when an attempt is made to link an assembly compiled with `/clr:safe`.
 
 For more information, see [.netmodule Files as Linker Input](../../build/reference/netmodule-files-as-linker-input.md).
 
+## Example
+
 The following sample generates C1308:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md
@@ -10,4 +10,6 @@ ms.assetid: a95363d6-a4f3-45fb-9690-aa7e552093b7
 
 > Mismatched versions of C2.DLL and PGODB\<version>.DLL
 
+## Remarks
+
 The toolset you are using to build and use [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) contains mismatched components.  If you cannot manually resolve this error, reinstall Visual C++.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md
@@ -10,8 +10,12 @@ ms.assetid: ac48aa51-8023-42fe-b844-3f8bf228fbef
 
 > profile guided optimizations are not available with OpenMP
 
+## Remarks
+
 You will not be able to link with [/LTCG:PGI](../../build/reference/ltcg-link-time-code-generation.md) any module that was compiled with [/GL](../../build/reference/gl-whole-program-optimization.md).
 
+## Example
+
 The following sample generates C1310:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md
@@ -10,10 +10,14 @@ ms.assetid: 6590a06c-ce9d-4f17-8f62-c809343143b8
 
 > COFF format cannot statically initialize 'var' with number byte(s) of an address
 
+## Remarks
+
 An address whose value is not known at compile time cannot be statically assigned to a variable whose type has storage of less than four bytes.
 
 This error can occur on code that is otherwise valid C++.
 
+## Example
+
 The following example shows one condition that might cause C1311.
 
 ```
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md
@@ -10,4 +10,6 @@ ms.assetid: 1aa7cd0e-d45f-4ae7-a85d-015ebb962eaf
 
 > Too many conditional branches in function. Simplify or refactor source code.
 
+## Remarks
+
 The code is too complex for the compiler to process without running out of stack memory.  Simplify your code.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md
@@ -10,4 +10,6 @@ ms.assetid: 6c7631c8-6fd7-476a-9303-564717fda0f9
 
 > compiler limit : type blocks may not be nested deeper than number levels
 
+## Remarks
+
 Exception handling (or structured exception handling) blocks were nested too deeply.  Simplify your code.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md
@@ -10,6 +10,8 @@ ms.assetid: 8bb47c23-ac9c-4a33-9ede-4d63ed9d4ba8
 
 > error loading dll 'dll': dll not found
 
+## Remarks
+
 The DLL that supports the attempted operation was not found.
 
 This indicates a problem with your installation and you should reinstall the DLL from your product CD.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md
@@ -10,6 +10,8 @@ ms.assetid: 1f8502e4-1049-49c7-bbe3-fa101c79021e
 
 > error loading dll '*dll*': incompatible version
 
+## Remarks
+
 The wrong version of a DLL was found.
 
 This indicates a problem with your installation, and you should reinstall Visual Studio.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md
@@ -10,6 +10,8 @@ ms.assetid: d044e8b0-b6ef-4d57-8eb5-6254071be707
 
 > Invalid or corrupt MSIL in function 'function' from module 'file'
 
+## Remarks
+
 A .netmodule was passed to the compiler, but the compiler detected corruption in the file.  Ask the person who produced the .netmodule to investigate.
 
 The compiler does not check .netmodule files for all types of corruption.  It does, however, check that all control paths in a function contain a return statement.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md
@@ -10,4 +10,6 @@ ms.assetid: 37f55b1d-9e7a-4932-a41e-d593190895d3
 
 > metadata operation failed: runtime not installed or version mismatch
 
+## Remarks
+
 Reinstall your CLR or Visual Studio.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md
@@ -10,6 +10,8 @@ ms.assetid: 7a100f8c-3179-4927-a2f1-98de4c753850
 
 > the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object
 
+## Remarks
+
 When using [/LTCG](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected a .pch file that is newer than a CIL .obj that points to it. The information in the CIL .obj file is out of date. Rebuild the object.
 
 C1382 can also occur if you compile with **/Yc**, but also pass multiple source code files to the compiler.  To resolve, do not use **/Yc** when passing multiple source code files to the compiler.  For more information, see [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md).
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md
@@ -10,6 +10,8 @@ ms.assetid: ca224d14-d687-4fd6-80c2-8b82f28924ea
 
 > compiler option /GL is incompatible with the installed version of common language runtime
 
+## Remarks
+
 C1383 occurs when you are using a previous version of the common language runtime with a newer compiler, and when you compile with **/clr** and **/GL.**
 
 To resolve, either do not use **/GL** with **/clr** or install the version of the common language runtime that shipped with your compiler.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md
@@ -10,6 +10,8 @@ ms.assetid: c73d5702-c898-4a32-b0fa-a118601a1e14
 
 > unrecoverable block scoping error
 
+## Remarks
+
 The block was too large to compile.
 
 ### To fix by checking the following possible causes
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md
@@ -10,4 +10,6 @@ ms.assetid: 1112c17d-d60f-470d-b886-fd1a9556c0ea
 
 > compiler limit : 'function' : more than 65535 argument bytes
 
+## Remarks
+
 The formal parameters to the function exceed the limit of 65535 bytes.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md
@@ -10,6 +10,8 @@ ms.assetid: 40dd100d-c6ba-451c-bd26-2c99ec1c36d6
 
 > compiler limit : too many exception handler states in function 'function'. simplify function
 
+## Remarks
+
 The code exceeds an internal limit on exception handler states (32,768 states).
 
 The most common cause is that the function contains a complex expression of user-defined class variables and arithmetic operators.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md
@@ -10,6 +10,8 @@ ms.assetid: 150c827f-9514-41a9-8d7e-82f820749bcb
 
 > Cannot open language resource clui.dll
 
+## Remarks
+
 The compiler can't load the language resource DLL.
 
 There are two common causes for this issue. When using the 32-bit compiler and tools, you may see this error for large projects that use more than 2GB of memory during a link. A possible solution on 64-bit Windows systems is to use the 64-bit native or cross compiler and tools to generate your code. This takes advantage of the larger memory space available to 64-bit apps. If you must use a 32-bit compiler because you are running on a 32-bit system, in some cases you can increase the amount of memory available to the linker to 3GB. For more information, see [4-Gigabyte Tuning: BCDEdit and Boot.ini](/windows/win32/memory/4-gigabyte-tuning) and the [BCDEdit /set increaseuserva](/windows-hardware/drivers/devtest/bcdedit--set) command.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md
@@ -10,4 +10,6 @@ ms.assetid: 25797c39-f085-4d75-9eab-159ecd36ef49
 
 > unsupported inline assembly opcode
 
+## Remarks
+
 This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md
@@ -10,4 +10,6 @@ ms.assetid: a9365c58-fe66-49c4-a702-9bb75429cc1a
 
 > unsupported intrinsic
 
+## Remarks
+
 This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products.
diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md
@@ -10,4 +10,6 @@ ms.assetid: e5a06925-f916-4637-8240-6d2d280e6124
 
 > inline assembly branch target out of range by 'number' bytes
 
+## Remarks
+
 The computed distance between a JCXZ or JECXZ instruction and its specified target label was greater than 128 bytes. Update your code so that the label is closer to the instruction.
