Add "Remarks" and "Example" headings for error references in range [C2701, C2730]

Rageking8 · web-flow · commit b0a2b5c3fa5a · 2025-08-05T22:56:33.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md
@@ -10,8 +10,12 @@ ms.assetid: 31cf2ab7-ced9-4f75-aa51-e169e20407fb
 
 > 'function': a function template cannot be a `friend` of a local class
 
+## Remarks
+
 A local class can't have a function template as a `friend` function.
 
+## Example
+
 The following sample generates C2701:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md
@@ -10,8 +10,12 @@ ms.assetid: 6def15d4-9a8d-43e7-ae35-42d7cb57c27e
 
 > `__except` may not appear in termination block
 
+## Remarks
+
 An exception handler (**`__try`**/**`__except`**) cannot be nested inside a **`__finally`** block.
 
+## Example
+
 The following sample generates C2702:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md
@@ -10,4 +10,6 @@ ms.assetid: 185797e2-55b5-4c11-8493-e70eb1d15a94
 
 > 'identifier' : __va_start intrinsic only allowed in varargs
 
+## Remarks
+
 The `__va_start` intrinsic is used in a declaration for a function with a fixed number of arguments.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md
@@ -10,8 +10,12 @@ ms.assetid: e18da924-c42d-4b09-8e29-f4e0382d7dc6
 
 > illegal `__except` without matching `__try` (missing '}' in `__try` block?)
 
+## Remarks
+
 The compiler did not find a closing brace for a **`__try`** block.
 
+## Example
+
 The following sample generates C2706:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md
@@ -10,6 +10,8 @@ ms.assetid: 3deaf45c-74da-4c9d-acc6-b82412720b74
 
 > 'identifier' : bad context for intrinsic function
 
+## Remarks
+
 Structured exception-handling intrinsics are invalid in certain contexts:
 
 - `_exception_code()` outside an exception filter or **`__except`** block
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md
@@ -10,6 +10,8 @@ ms.assetid: d52d3088-1141-42f4-829c-74755a7fcc3a
 
 > 'identifier' : actual parameters length in bytes differs from previous call or reference
 
+## Remarks
+
 A [__stdcall](../../cpp/stdcall.md) function must be preceded by a prototype. Otherwise, the compiler interprets the first call to the function as a prototype and this error occurs when the compiler encounters a call that does not match.
 
 To fix this error add a function prototype.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md
@@ -10,4 +10,6 @@ ms.assetid: e66fc7e6-0e91-4b99-a6e0-fdb069b09fbc
 
 > 'identifier' : formal parameter's length in bytes differs from previous declaration
 
+## Remarks
+
 The signature in a call to the specified function differs from the prototype.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md
@@ -10,8 +10,12 @@ ms.assetid: a2a6bb5b-86ad-4a6c-acd0-e2bef8464e0e
 
 > 'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer
 
+## Remarks
+
 A function whose return value is a pointer is the only construct to which `modifier` can be applied.
 
+## Example
+
 The following sample generates C2710:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md
@@ -10,8 +10,12 @@ ms.assetid: 9df9f808-7419-4e63-abdd-e6538ff0871f
 
 > 'function' : this function cannot be compiled as managed, consider using #pragma unmanaged
 
+## Remarks
+
 Some instructions will prevent the compiler from generating MSIL for the enclosing function.
 
+## Example
+
 The following sample generates C2711:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md
@@ -10,4 +10,6 @@ ms.assetid: bae9bee3-b4b8-4be5-b6a5-02df587a7278
 
 > only one form of exception handling permitted per function
 
+## Remarks
+
 You can't use structured exception handling (**`__try`**/**`__except`**) and C++ exception handling (**`try`**/**`catch`**) in the same function.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md
@@ -10,10 +10,10 @@ ms.assetid: 401a5a42-660c-4bad-9d63-1a2d092bc489
 
 > `alignof(void)` is not allowed
 
-An invalid value was passed to an operator.
-
 ## Remarks
 
+An invalid value was passed to an operator.
+
 See [`alignof` operator](../../cpp/alignof-operator.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md
@@ -10,8 +10,12 @@ ms.assetid: c81567a7-5b65-468f-aaf9-835f91e468e4
 
 > 'type' : cannot throw or catch this type
 
+## Remarks
+
 Value types are not valid arguments when using exception handling in managed code (see [Exception Handling](../../extensions/exception-handling-cpp-component-extensions.md) for more information).
 
+## Example
+
 ```cpp
 // C2715a.cpp
 // compile with: /clr
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md
@@ -10,8 +10,12 @@ ms.assetid: 78cc71f8-c142-46fc-9aed-970635d74f0c
 
 > 'parameter': actual parameter with __declspec(align('#')) won't be aligned
 
+## Remarks
+
 The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters.
 
+## Example
+
 The following sample generates C2718:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md
@@ -10,8 +10,12 @@ ms.assetid: ea6236d3-8286-45cc-9478-c84ad3dd3c8e
 
 > 'parameter': formal parameter with __declspec(align('#')) won't be aligned
 
+## Remarks
+
 The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. Function parameter alignment is controlled by the calling convention used. For more information, see [Calling Conventions](../../cpp/calling-conventions.md).
 
+## Example
+
 The following sample generates C2719 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md
@@ -10,6 +10,8 @@ ms.assetid: 9ee3aab7-711b-4f5a-b2f1-cb62b130f1ce
 
 > '*identifier*' : '*specifier*' storage-class specifier illegal on members
 
+## Remarks
+
 The storage class cannot be used on class members outside the declaration. To fix this error, remove the unneeded [storage class](../../cpp/storage-classes-cpp.md) specifier from the definition of the member outside the class declaration.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md
@@ -10,4 +10,6 @@ ms.assetid: 7a97823c-3ce1-4112-8253-fc1448685235
 
 > 'specifier' : storage-class specifier illegal between operator keyword and type
 
+## Remarks
+
 User-defined type conversions apply to all storage classes, so you cannot specify a storage class in a type conversion.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md
@@ -10,4 +10,6 @@ ms.assetid: 4cc2c7fa-cb12-4bcf-9df1-6d627ef62973
 
 > '::operator' : illegal following operator command; use 'operator operator'
 
+## Remarks
+
 An `operator` statement redefines `::new` or `::delete`. The `new` and `delete` operators are global, so the scope resolution operator (`::`) is meaningless. Remove the `::` operator.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md
@@ -10,8 +10,12 @@ ms.assetid: 86925601-2297-4cfd-94e2-2caf27c474c4
 
 > 'function' : 'specifier' specifier illegal on function definition
 
+## Remarks
+
 The specifier cannot appear with a function definition outside of a class declaration. The **`virtual`** specifier can be specified only on a member function declaration within a class declaration.
 
+## Example
+
 The following sample generates C2723 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2724"]
 
 > 'identifier' : 'static' should not be used on member functions defined at file scope
 
+## Remarks
+
 Static member functions should be declared with external linkage.
 
+## Example
+
 The following sample generates C2724:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md
@@ -10,6 +10,8 @@ ms.assetid: 13cd5b1b-e906-4cd8-9b2b-510d587c665a
 
 > 'exception' : unable to throw or catch a managed or WinRT object by value or reference
 
+## Remarks
+
 The type of a managed or WinRT exception was not correct.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md
@@ -10,8 +10,12 @@ ms.assetid: f0191bb7-c175-450b-bf09-a3213db96d09
 
 > 'gcnew' may only be used to create an object with managed or WinRT type
 
+## Remarks
+
 You cannot create an instance of a native type on the garbage-collected heap.
 
+## Example
+
 The following sample generates C2726 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md
@@ -10,10 +10,14 @@ ms.assetid: 65635f91-1cd1-46e4-9ad7-14726d0546af
 
 > 'type' : a native array cannot contain this type
 
+## Remarks
+
 Array creation syntax was used to create an array of managed or WinRT objects. You cannot create an array of managed or WinRT objects using native array syntax.
 
 For more information, see [array](../../extensions/arrays-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C2728 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md
@@ -10,4 +10,6 @@ ms.assetid: 07f0b17a-bc8e-4d79-af5a-07a07af3687b
 
 > 'class' : cannot be a base class of itself
 
+## Remarks
+
 Recursive base classes are invalid. Specify another class as the base class.
