Add "Remarks" and "Example" headings for error references in range [C2761, C2790]

Rageking8 · web-flow · commit 8cc9edd3907b · 2025-08-07T23:19:15.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md
@@ -10,6 +10,8 @@ ms.assetid: 38c79a05-b56d-485b-820f-95e8c0cb926f
 
 > 'function' : member function redeclaration not allowed
 
+## Remarks
+
 You cannot redeclare a member function. You can define it, but not redeclare it.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md
@@ -10,8 +10,12 @@ ms.assetid: 8b81a801-fd48-40a1-8bee-0748795b12e4
 
 > 'class' : invalid expression as a template argument for 'argument'
 
+## Remarks
+
 When using [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler will not convert an integral to a pointer.
 
+## Example
+
 The following sample generates C2762:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md
@@ -10,6 +10,8 @@ ms.assetid: 3754f5af-e094-4425-be20-d0c9a9b5baec
 
 > 'param' : template parameter not used or deducible in partial specialization 'specialization'
 
+## Remarks
+
 A template parameter is not used in a partial specialization. This makes the partial specialization unusable because the template parameter cannot be deduced.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2765"]
 
 > 'function' : an explicit specialization of a function template cannot have any default arguments
 
+## Remarks
+
 Default arguments are not allowed on an explicit specialization of a function template. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md).
 
+## Example
+
 The following sample generates C2765:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md
@@ -10,8 +10,12 @@ ms.assetid: 8032f4ca-6827-4f04-9c61-c44643c85cc4
 
 > explicit specialization; 'specialization' has already been defined
 
+## Remarks
+
 Duplicate explicit specializations are not allowed. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md).
 
+## Example
+
 The following sample generates C2766:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md
@@ -10,8 +10,12 @@ ms.assetid: e8f84178-a160-4d71-a236-07e4fcc11e96
 
 > managed or WinRTarray dimension mismatch : expected N argument(s) - M provided
 
+## Remarks
+
 A managed or WinRT array declaration was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C2767 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md
@@ -10,8 +10,12 @@ ms.assetid: 100001b5-80b0-4971-8ff6-9023f443c926
 
 > invalid explicit template_or_generic argument(s) for 'template'
 
+## Remarks
+
 Function template candidates with explicit template or generic arguments resulted in disallowed function types.
 
+## Example
+
 The following sample generates C2770:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md
@@ -10,4 +10,6 @@ ms.assetid: b649cc9f-7cbc-4b42-a5e8-51dad5c55e4b
 
 > #import only permitted at global or namespace scope
 
+## Remarks
+
 The `#import` directive is not allowed in, for example, a function or structure.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md
@@ -10,4 +10,6 @@ ms.assetid: 8d564b26-1623-4d92-aabc-dff33f7b1145
 
 > #import and #using available only in C++ compiler
 
+## Remarks
+
 The C compiler does not recognize the `#import` preprocessor directive. Compile the source as C++. Use [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) if necessary.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md
@@ -10,8 +10,12 @@ ms.assetid: 10f428c6-7f49-489a-92ba-6ef978b7caaf
 
 > 'identifier' : no 'put' method is associated with this property
 
+## Remarks
+
 A data member declared with [property](../../cpp/property-cpp.md) has no `put` function, but an expression tries to set its value.
 
+## Example
+
 The following sample generates C2774:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md
@@ -10,8 +10,12 @@ ms.assetid: 9c488508-ade0-48f1-b94f-d538d15f807a
 
 > 'identifier' : no 'get' method is associated with this property
 
+## Remarks
+
 A data member declared with the [property](../../cpp/property-cpp.md) extended attribute does not have a `get` function specified, but an expression tries to retrieve its value.
 
+## Example
+
 The following sample generates C2775:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md
@@ -10,8 +10,12 @@ ms.assetid: 9d80addc-62c7-40fc-a2cc-60303abb87df
 
 > only one 'get' method can be specified per property
 
+## Remarks
+
 You can only specify one `get` function in the [property](../../cpp/property-cpp.md) extended attribute. This error occurs when multiple `get` functions are specified.
 
+## Example
+
 The following sample generates C2776:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md
@@ -10,8 +10,12 @@ ms.assetid: 5fe158c0-2a65-488a-aca2-61d4a8b32d43
 
 > only one 'put' method can be specified per property
 
+## Remarks
+
 A [property](../../cpp/property-cpp.md) declspec modifier had more than one `put` property.
 
+## Example
+
 The following sample generates C2777:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md
@@ -10,8 +10,12 @@ ms.assetid: b24cb732-2914-42cc-8928-e2d87b393428
 
 > improperly formed GUID in __declspec(uuid())
 
+## Remarks
+
 An incorrect GUID is supplied to the [uuid](../../cpp/uuid-cpp.md) extended attribute.
 
+## Example
+
 The GUID must be a string of hexadecimal numbers with the following format:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md
@@ -10,8 +10,12 @@ ms.assetid: 4a00e492-855a-41f3-8a18-5f60ee20c2f2
 
 > 'declaration' : property methods can only be associated with non-static data members
 
+## Remarks
+
 The **`property`** extended attribute is incorrectly applied to a static data member.
 
+## Example
+
 The following sample generates C2779:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md
@@ -10,8 +10,12 @@ ms.assetid: 423793d8-a3b2-4f35-85f8-ae1d043e2b69
 
 > 'declaration' : expects N arguments - M provided
 
+## Remarks
+
 A function template has too few or too many arguments.
 
+## Example
+
 The following sample generates C2780 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md
@@ -10,8 +10,12 @@ ms.assetid: f29b9963-f55b-427c-8db6-50f37713df5a
 
 > 'declaration' : expects at least value1 argument - value2 provided
 
+## Remarks
+
 A function template with a variable parameter list has too few arguments.
 
+## Example
+
 The following sample generates C2781:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md
@@ -10,8 +10,12 @@ ms.assetid: 8b685422-294d-4f64-9f3d-c14eaf03a93d
 
 > 'declaration' : template parameter 'identifier' is ambiguous
 
+## Remarks
+
 The compiler cannot determine the type of a template argument.
 
+## Examples
+
 The following sample generates C2782:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md
@@ -10,8 +10,12 @@ ms.assetid: 1ce94a11-bb8b-4be3-a222-f1f105da74b3
 
 > 'declaration' : could not deduce template argument for 'identifier'
 
+## Remarks
+
 The compiler cannot determine a template argument. Default arguments cannot be used to deduce a template argument.
 
+## Examples
+
 The following sample generates C2783:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md
@@ -10,8 +10,12 @@ ms.assetid: 3d761fe2-881c-48bd-afae-e2e714e20473
 
 > 'declaration' : could not deduce template argument for 'type' from 'type'
 
+## Remarks
+
 The compiler cannot determine a template argument from the supplied function arguments.
 
+## Example
+
 The following sample generates C2784 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md
@@ -10,6 +10,8 @@ ms.assetid: d8d13360-0d00-4815-8475-b49c7f0dc0f3
 
 > 'declaration1' and 'declaration2' have different return types
 
+## Remarks
+
 The return type of function template specialization differs from the return type of the primary function template.
 
 ### To correct this error
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md
@@ -10,12 +10,16 @@ ms.assetid: 6676d8c0-86dd-4a39-bdda-b75a35f4d137
 
 > 'type' : invalid operand for __uuidof
 
+## Remarks
+
 The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type.  Possible causes:
 
 1. The argument is not a user-defined type.
 
 1. **`__uuidof`** cannot extract the GUID from the argument.
 
+## Example
+
 The following sample generates C2786:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md
@@ -10,8 +10,12 @@ ms.assetid: 34cb57e6-cafe-4ce7-bcc6-53d194629bd0
 
 > 'identifier' : no GUID has been associated with this object
 
+## Remarks
+
 The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is a user-defined type with no GUID.
 
+## Example
+
 The following sample generates C2787:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md
@@ -10,8 +10,12 @@ ms.assetid: 8688fc5c-e652-43b4-b407-9c488c76f2db
 
 > 'identifier' : more than one GUID associated with this object
 
+## Remarks
+
 The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is an object with multiple GUIDs.
 
+## Example
+
 The following sample generates C2788:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md
@@ -10,8 +10,12 @@ ms.assetid: 38d4fce1-ba00-413d-8bc1-e8aa43d7bc1f
 
 > 'super' : this keyword can only be used within the body of class member function
 
+## Remarks
+
 This error message appears if the user ever tries to uses the keyword [super](../../cpp/super.md) outside of the context of a member function.
 
+## Example
+
 The following sample generates C2790:
 
 ```cpp
