Add "Remarks" and "Example" headings for error references in range [C3281, C3350]

Rageking8 · web-flow · commit 4dc1b841c632 · 2025-08-18T01:29:57.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md
@@ -10,6 +10,8 @@ ms.assetid: bac2ac89-c360-4c24-bb81-c20c62ece9ba
 
 > generic parameter lists can only appear on managed or WinRTclasses, structs, or functions
 
+## Remarks
+
 A generic parameter list was used incorrectly.  For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md
@@ -10,8 +10,12 @@ ms.assetid: c51d912c-cde3-4928-904e-26734c8954ce
 
 > 'type' : an interface cannot have an instance constructor
 
+## Remarks
+
 A CLR [interface](../../extensions/interface-class-cpp-component-extensions.md) cannot have an instance constructor.  A static constructor is allowed.
 
+## Example
+
 The following sample generates C3283:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md
@@ -10,8 +10,12 @@ ms.assetid: e582f316-e9db-4d27-9c70-fdfa737a9d5f
 
 > the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function'
 
+## Remarks
+
 A virtual generic function must use the same constraints as a virtual function with the same name and set of arguments in the base class.
 
+## Example
+
 The following sample generates C3284:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md
@@ -10,6 +10,8 @@ ms.assetid: 04e8f210-d67e-4810-b153-e1efe2986c8f
 
 > for each statement cannot operate on variables of type 'type'
 
+## Remarks
+
 The `for each` statement repeats a group of embedded statements for each element in an array or an object collection.
 
 See [for each, in](../../dotnet/for-each-in.md) for more information.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md
@@ -10,6 +10,8 @@ ms.assetid: 554328c8-cf44-4f7d-a8d2-def74d28ecdd
 
 > '*specifier*': an iteration variable cannot have any storage-class specifiers
 
+## Remarks
+
 A storage class can't be specified on an iteration variable. For more information, see [Storage classes (C++)](../../cpp/storage-classes-cpp.md) and [for each, in](../../dotnet/for-each-in.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md
@@ -10,6 +10,8 @@ ms.assetid: ed08a540-9751-46e1-9cbe-c51d6a49ffab
 
 > 'type' : illegal dereference of a handle type
 
+## Remarks
+
 The compiler detected an illegal dereference of a handle type. You can dereference a handle type and assign it to a reference. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md
@@ -10,6 +10,8 @@ ms.assetid: 3c1c623b-7fcf-43ab-a89a-8722532a8d29
 
 > 'property' : a trivial property cannot be indexed
 
+## Remarks
+
 A property was declared incorrectly. Accessors must be defined for an indexed property. See [property](../../extensions/property-cpp-component-extensions.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md
@@ -10,6 +10,8 @@ ms.assetid: 0baf684b-1143-4953-ac99-a2fa267d8017
 
 > 'type' : a trivial property cannot have reference type
 
+## Remarks
+
 A property was declared incorrectly. When you declare a trivial property, the compiler creates a variable that the property will update, and it is not possible to have a tracking reference variable in a class.
 
 See [property](../../extensions/property-cpp-component-extensions.md) and [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md) for more information.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md
@@ -10,6 +10,8 @@ ms.assetid: ed2e9f89-8dbc-4387-bc26-cc955e840858
 
 > 'default' : cannot be the name of a trivial property
 
+## Remarks
+
 A trivial property cannot be named **`default`**. See [property](../../extensions/property-cpp-component-extensions.md) for more information.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md
@@ -10,6 +10,8 @@ ms.assetid: ead485cc-5471-4e10-b361-300589ff5b70
 
 > the cli namespace cannot be reopened
 
+## Remarks
+
 The cli namespace cannot be declared in your code.  For more information, see [Platform, default, and cli Namespaces](../../extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md
@@ -10,6 +10,8 @@ ms.assetid: b772cf98-52e0-4e24-be23-1f5d87d999ac
 
 > 'accessor': use 'default' to access the default property (indexer) for class 'type'
 
+## Remarks
+
 An indexed property was accessed incorrectly.  See [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md) for more information.
 
 **Visual Studio 2017 and later**: In Visual Studio 2015 and earlier, the compiler in some cases misidentified a default property as a default indexer. It was possible to work around the issue by using the identifier "default" to access the property. The workaround itself became problematic after default was introduced as a keyword in C++11. Therefore, in Visual Studio 2017 the bugs that required the workaround were fixed, and the compiler now raises an error when "default" is used to access the default property for a class.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md
@@ -10,6 +10,8 @@ ms.assetid: fc4c9dcd-16cf-4eee-a1ac-c43e7c29e443
 
 > 'property' : a property with this name already exists
 
+## Remarks
+
 The compiler encountered more than one property with the same name. Each property in a type must have a unique name.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md
@@ -10,6 +10,8 @@ ms.assetid: 2a718b4c-6cdb-4418-92c0-fc3a259431c4
 
 > 'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint
 
+## Remarks
+
 Value classes are sealed. If a constraint is a value class, another constraint can never derive from it.
 
 For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md
@@ -10,6 +10,8 @@ ms.assetid: 458c2680-95bb-4d5e-895f-ce4115844193
 
 > 'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint
 
+## Remarks
+
 You cannot specify mutually exclusive characteristics for a constraint. For example, a generic type parameter cannot be constrained to both a value type and a reference type.
 
 For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md
@@ -10,6 +10,8 @@ ms.assetid: 7cabdf01-bceb-404f-9401-cdd9c7fc1641
 
 > 'member_function' : cannot specify constraints, they are inherited from the base method
 
+## Remarks
+
 When overriding a generic member function, you cannot specify constraint clauses (repeating the constraints implies that the constraints are not inherited).
 
 The constraint clauses on the generic function you are overriding will be inherited.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md
@@ -10,4 +10,6 @@ ms.assetid: c6f6ea3d-f6b7-4401-8bbb-f283a2c05540
 
 > 'attribute': attribute can only be used on 'usage'
 
+## Remarks
+
 An attempt was made to use an attribute where it is not valid.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md
@@ -10,8 +10,12 @@ ms.assetid: 75ee16e3-7d4e-4c41-b3cb-64e9849c3aab
 
 > 'macro_name': module name cannot be a macro or a keyword
 
+## Remarks
+
 The value that you pass to the name property of the module attribute cannot be a symbol for the preprocessor to expand; it must be a string literal.
 
+## Example
+
 The following sample generates C3309:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md
@@ -10,6 +10,8 @@ ms.assetid: 2ef72d9a-1f1d-4b2e-b244-9fd3f3e70cb6
 
 > 'type': type cannot have the same name as the module 'name' property
 
+## Remarks
+
 An exported user-defined type (UDT), which could be a struct, class, enum, or union, cannot have the same name as the parameter passed to the [module](../../windows/attributes/module-cpp.md) attribute's name property.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md
@@ -10,4 +10,6 @@ ms.assetid: d8a0ad95-30df-4337-b0c8-4747de0bef50
 
 > 'property': is not a valid property for attribute 'attribute'
 
+## Remarks
+
 An invalid or unrecognized property (or parameter) was passed to an attribute. Check the documentation for the attribute.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md
@@ -10,4 +10,6 @@ ms.assetid: 51693978-fba6-435a-a696-74735cc875de
 
 > 'type library': cannot #import corrupt type library
 
+## Remarks
+
 The type library specified in the `#import` statement is unreadable by the compiler. You may want to either regenerate the type library, if possible, or request a new type library from your supplier. You may want to use the OLE Viewer, supplied with Visual C++, to view the type library file to see what is the matter with it.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md
@@ -10,6 +10,8 @@ ms.assetid: e972c625-77e7-4022-8aba-e1db01d7a0d7
 
 > cannot #import corrupt type library
 
+## Remarks
+
 The library file in a `#import` statement is corrupt and can't be consumed by the compiler.  Corruption can come from bad generation of the module, disk corruption, or if the binary file was somehow edited and modified.
 
 For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md
@@ -10,8 +10,12 @@ ms.assetid: 23b12298-b92a-4717-8380-f165c998cb8a
 
 > 'interface': interface cannot be both 'restricted' and 'default' in coclass 'class'
 
+## Remarks
+
 The [restricted](../../windows/attributes/restricted.md) attribute and the [default](../../windows/attributes/default-cpp.md) attribute are mutually exclusive.
 
+## Example
+
 The following sample generates C3340:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md
@@ -10,6 +10,8 @@ ms.assetid: 5c6d784f-bebe-4f7e-8615-44ca6f78bfba
 
 > 'attribute': ambiguous attribute
 
+## Remarks
+
 The compiler found more than one definition of an attribute.
 
 An attribute was defined more than once.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md
@@ -10,6 +10,8 @@ ms.assetid: 1dda4c79-73bb-441b-b939-746154c3afba
 
 > 'identifier': invalid identifier for module name
 
+## Remarks
+
 The *identifier* for a module contains one or more unacceptable characters. An identifier is valid if the first character is an alphabetical, underscore, or high ANSI (0x80-FF) character, and any subsequent character is an alphanumeric, underscore, or high ANSI character.
 
 ### To correct this error
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md
@@ -10,8 +10,12 @@ ms.assetid: e939ad29-0b78-4681-9618-9bdae5675cee
 
 > 'arg': required argument is not specified in attribute idl_module
 
+## Remarks
+
 A required argument was not passed to the [idl_module](../../windows/attributes/idl-module.md) attribute.
 
+## Example
+
 The following sample generates C3347:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md
@@ -10,8 +10,12 @@ ms.assetid: cfbbc338-92b5-4f34-999e-aa2d2376bc70
 
 > 'delegate' : a delegate constructor expects number argument(s)
 
+## Remarks
+
 When you create an instance of a delegate, you must pass two arguments, an instance of the type containing the delegate function, and the function.
 
+## Example
+
 The following sample generates C3350:
 
 ```cpp
