Add "Remarks" and "Example" headings for error references in range [C3081, C3130]

Rageking8 · web-flow · commit 926b19f625b0 · 2025-08-14T22:07:44.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md
@@ -10,6 +10,8 @@ ms.assetid: 0362cb70-e24e-476f-a24d-8f5bb97c3afd
 
 > 'function': a finalizer/destructor cannot be 'keyword'
 
+## Remarks
+
 A finalizer or destructor was declared incorrectly.
 
 For example, a destructor should not be marked as sealed.  The destructor will be inaccessible to derived types.  For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) and [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md
@@ -10,6 +10,8 @@ ms.assetid: 1ac40bf2-f63e-439e-8921-47e6dadc8354
 
 > 'constructor': a constructor cannot be 'keyword'
 
+## Remarks
+
 A constructor was declared incorrectly. See [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md
@@ -10,6 +10,8 @@ ms.assetid: 4f5bdd52-a853-4f02-b160-6868e9190b9d
 
 > 'named_argument': call of 'attribute' already initializes this member
 
+## Remarks
+
 A named argument was specified in the same attribute block as an unnamed argument for the same value. Specify only a named or unnamed argument.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md
@@ -10,6 +10,8 @@ ms.assetid: 10da9b7c-e72d-4013-9925-c83e1bb142db
 
 > 'attribute': anonymous usage not allowed
 
+## Remarks
+
 An attribute was not scoped correctly.  For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md
@@ -10,6 +10,8 @@ ms.assetid: cde725be-0936-40f6-9e57-e1d7d0710f83
 
 > 'attribute': attribute cannot be repeated
 
+## Remarks
+
 Some attributes are declared such that, multiple occurrences of the attribute cannot be applied to a target.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md
@@ -10,6 +10,8 @@ ms.assetid: 56353c9a-800c-474f-b428-3e5d2a7afc9a
 
 > 'attribute': attribute is allowed on data members of attribute classes only
 
+## Remarks
+
 An attribute was applied incorrectly.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md
@@ -10,6 +10,8 @@ ms.assetid: b24bd8f8-e04f-4fbb-be57-4feb9165572e
 
 > 'attribute': attribute must be scoped with 'assembly:' or 'module:'
 
+## Remarks
+
 A global attribute was used incorrectly.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md
@@ -10,6 +10,8 @@ ms.assetid: b3dded0f-76c9-42c1-991b-532eb8619661
 
 > 'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes
 
+## Remarks
+
 Use <xref:System.AttributeUsageAttribute> to declare **/clr** attributes. Use `Windows::Foundation::Metadata::AttributeUsageAttribute` to declare Windows Runtime attributes.
 
 For more information about /CLR attributes, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). For supported attributes in Windows Runtime, see [Windows.Foundation.Metadata namespace](/uwp/api/windows.foundation.metadata)
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md
@@ -10,6 +10,8 @@ ms.assetid: 7a9c9eaf-08ef-442d-94a0-e457beee8549
 
 > 'target' : unknown attribute qualifier
 
+## Remarks
+
 An invalid attribute target was specified.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md
@@ -10,6 +10,8 @@ ms.assetid: 4f673766-d4f7-4632-94a5-d36a83f7f4b5
 
 > illegal expression for named attribute argument 'field'
 
+## Remarks
+
 When initializing a named attribute argument, the value must be a compile time constant.
 
 For more information on attributes, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md
@@ -10,6 +10,8 @@ ms.assetid: 7984bd3e-d51d-43e4-b6f4-08c1e9fb9704
 
 > 'argument': repeated named argument
 
+## Remarks
+
 An attribute can not repeat named arguments.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md
@@ -10,6 +10,8 @@ ms.assetid: b5648d47-e5d3-4b45-a3c0-f46e04eae731
 
 > illegal attribute argument
 
+## Remarks
+
 You specified an invalid argument to an attribute.
 
 See [Attribute Parameter Types](../../extensions/attribute-parameter-types-cpp-component-extensions.md) for more information.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md
@@ -10,6 +10,8 @@ ms.assetid: 39d97a32-0905-4702-87d3-7f8ce473fb93
 
 > 'attribute': unnamed arguments must precede named arguments
 
+## Remarks
+
 Unnamed arguments must be passed to an attribute before named arguments.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md
@@ -10,6 +10,8 @@ ms.assetid: 821dc71f-896e-4b2d-af0e-aa9932934b7b
 
 > 'function_name' : you cannot overload a COM interface method
 
+## Remarks
+
 An interface that is prefaced by an interface attribute, such as:
 
 - [custom](../../windows/attributes/custom-cpp.md)
@@ -20,7 +22,11 @@ An interface that is prefaced by an interface attribute, such as:
 
 - [object](../../windows/attributes/object-cpp.md)
 
-cannot be overloaded. For example:
+cannot be overloaded.
+
+## Example
+
+For example:
 
 ```cpp
 // C3110.cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md
@@ -10,8 +10,12 @@ ms.assetid: 3afdc668-b29e-474e-9ea3-aa027d42db7c
 
 > an 'structure' cannot be a template/generic
 
+## Remarks
+
 You attempted to make a class template or class generic out of an interface or an enum.
 
+## Example
+
 The following sample generates C3113:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md
@@ -10,6 +10,8 @@ ms.assetid: b5d2df4f-87d0-4292-9981-25c6a6013c05
 
 > 'argument': not a valid named attribute argument
 
+## Remarks
+
 In order for an attribute class data member to be a valid named argument, it must not be marked **`static`**, **`const`**, or **`literal`**. If a property, the property must not be **`static`** and must have get and set accessors.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md) and [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md
@@ -10,6 +10,8 @@ ms.assetid: 51726145-9782-4ec9-84b9-286f366d9cbd
 
 > 'attribute': this attribute is not allowed on 'construct'
 
+## Remarks
+
 An attribute was applied to a construct for which it was not intended.  See [Attributes by Usage](../../windows/attributes/attributes-by-usage.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md
@@ -10,8 +10,12 @@ ms.assetid: 597463e1-a5cc-4ed3-a917-eae9a61d3312
 
 > 'storage specifier' : invalid storage class for interface method
 
+## Remarks
+
 You used **`typedef`**, **`register`**, or **`static`** as the storage class for an interface method. These storage classes are not permitted on interface members.
 
+## Example
+
 The following sample generates C3116:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md
@@ -10,8 +10,12 @@ ms.assetid: dceee392-d4c7-4599-b75e-7aaac7c36fdd
 
 > '%$S' : an interface can only have one base class
 
+## Remarks
+
 You declared an interface that inherits from multiple base classes.
 
+## Example
+
 The following sample generates C3117:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md
@@ -10,7 +10,13 @@ ms.assetid: 40fbe681-8868-4cb2-a2b2-4db4449319a7
 
 > 'interface' : interfaces do not support virtual inheritance
 
-You tried to virtually inherit from an interface. For example,
+## Remarks
+
+You tried to virtually inherit from an interface.
+
+## Example
+
+For example,
 
 ```cpp
 // C3118.cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md
@@ -10,7 +10,13 @@ ms.assetid: 9b6b210f-9948-4517-a4cc-b4aaadebde68
 
 > 'method_name' : interface methods cannot take a variable argument list
 
-An interface method cannot take a variable argument list. For example, the following interface definition generates C3120:
+## Remarks
+
+An interface method cannot take a variable argument list.
+
+## Example
+
+For example, the following interface definition generates C3120:
 
 ```cpp
 // C3120.cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md
@@ -10,8 +10,12 @@ ms.assetid: 1d3c7be4-d42d-4def-8d53-182c0c5cc237
 
 > cannot change GUID for class 'class_name'
 
+## Remarks
+
 You attempted to change the class ID with [__declspec(uuid)](../../cpp/uuid-cpp.md).
 
+## Example
+
 For example, the following code generates C3121:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md
@@ -10,8 +10,12 @@ ms.assetid: e72658a3-5d85-4a31-89a4-dbc3d475973d
 
 > cannot define a union 'union' inside of managed type 'type'
 
+## Remarks
+
 A union cannot be defined inside a managed type.
 
+## Example
+
 The following sample generates C3126:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md
@@ -10,4 +10,6 @@ ms.assetid: c1462f33-434f-41f0-937e-392864916850
 
 > Internal Compiler Error: failed to write injected code block to PDB
 
+## Remarks
+
 This error occurs if the compiler failed to write an injected code block to the .pdb file. The most common reason for the failure is lack of disk space.
