Add "Remarks" and "Example" headings for error references in range [C3891, C3999]

Rageking8 · web-flow · commit e573870f1671 · 2025-08-24T21:49:55.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md
@@ -10,8 +10,12 @@ ms.assetid: 6e1a9458-97f5-4580-bc0f-aa97a1bfd20d
 
 > 'var' : a literal data member cannot be used as a l-value
 
+## Remarks
+
 A [literal](../../extensions/literal-cpp-component-extensions.md) variable is const, and its value cannot be changed after it is initialized in the declaration.
 
+## Example
+
 The following sample generates C3891:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md
@@ -10,8 +10,12 @@ ms.assetid: 83fff42c-ea48-442f-bc2e-b33a6b99d890
 
 > 'var' : you cannot assign to a variable that is const
 
+## Remarks
+
 A const variable cannot be changed after it is declared and initialized.
 
+## Example
+
 The following sample generates C3892:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md
@@ -10,10 +10,14 @@ ms.assetid: 90d52eae-6ef2-4db1-b7ad-92f9e8b140fb
 
 > 'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name'
 
+## Remarks
+
 Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only have their address taken in a static constructor.
 
 Instance (non-static) initonly data members can only have their address taken in instance (non-static) constructors.
 
+## Example
+
 The following sample generates C3893:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md
@@ -10,10 +10,14 @@ ms.assetid: 6d5ac903-1dea-431d-8e3a-cebca4342983
 
 > 'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class'
 
+## Remarks
+
 Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only be used as l-values at their point of declaration, or in a static constructor.
 
 Instance (non-static) initonly data members can only be used as l-values at their point of declaration, or in instance (non-static) constructors.
 
+## Example
+
 The following sample generates C3894:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md
@@ -10,8 +10,12 @@ ms.assetid: 771b9fe5-d6d4-4297-bf57-e2f857722155
 
 > 'var' : type data members cannot be 'volatile'
 
+## Remarks
+
 Certain kinds of data members, for example [literal](../../extensions/literal-cpp-component-extensions.md) or [initonly](../../dotnet/initonly-cpp-cli.md), cannot be [volatile](../../cpp/volatile-cpp.md).
 
+## Example
+
 The following sample generates C3895:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md
@@ -10,8 +10,12 @@ ms.assetid: eb8be0f6-5b4e-4d71-8285-8a2a94f8ba29
 
 > 'member' : improper initializer: this literal data member can only be initialized with 'nullptr'
 
+## Remarks
+
 A [literal](../../extensions/literal-cpp-component-extensions.md) data member was initialized incorrectly.  See [nullptr](../../extensions/nullptr-cpp-component-extensions.md) for more information.
 
+## Example
+
 The following sample generates C3896:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md
@@ -10,8 +10,12 @@ ms.assetid: d9a90df6-87e4-4fe7-ab01-c226ee86bf10
 
 > 'var' : type data members can only be members of managed types
 
+## Remarks
+
 An [initonly](../../dotnet/initonly-cpp-cli.md) data member was declared in a native class.  An **`initonly`** data member can only be declared in a CLR class.
 
+## Example
+
 The following sample generates C3898:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md
@@ -10,6 +10,8 @@ ms.assetid: 14e07e4a-f7a7-4309-baaa-649d69e12e23
 
 > 'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class'
 
+## Remarks
+
 An [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member cannot be initialized inside that part of a constructor that is in a [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) region.  This is because the compiler does an internal relocation of that code, such that, it is effectively no longer part of the constructor.
 
 To resolve, initialize the initonly data member in the constructor, but outside the parallel region.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md
@@ -10,10 +10,14 @@ ms.assetid: a94cc561-8fa8-4344-9e01-e81ff462fae5
 
 > 'member': not allowed in current scope
 
+## Remarks
+
 Property blocks can contain function declarations and inline function definitions only. No members other than functions are allowed in property blocks. No typedefs, operators, or friend functions are allowed. For more information, see [property](../../extensions/property-cpp-component-extensions.md).
 
 Event definitions can only contain access methods and functions.
 
+## Examples
+
 The following sample generates C3900:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md
@@ -10,8 +10,12 @@ ms.assetid: 19af4141-39ad-4c16-a68f-3ae76f648186
 
 > 'accessor_function': must have return type 'type'
 
+## Remarks
+
 At least one get method's return type must match the property type. For more information, see [property](../../extensions/property-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3901:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md
@@ -10,8 +10,12 @@ ms.assetid: feb3bb29-f836-4d77-ba71-3876f7f4f216
 
 > 'accessor': type of last parameter must be 'type'
 
+## Remarks
+
 The type of the last parameter of at least one set method must match the type of the property. For more information, see [property](../../extensions/property-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3902:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md
@@ -10,8 +10,12 @@ ms.assetid: cf47d7ad-a3bd-4f75-a253-71586e7a3be6
 
 > 'property': does not have set or get method
 
+## Remarks
+
 A property must have at least a `get` or a `set` method. For more information, see [property](../../extensions/property-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3903:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md
@@ -10,6 +10,8 @@ ms.assetid: 08297605-e4f2-4c6c-b637-011f1fd40631
 
 > 'property_accessor': must specify number parameter(s)
 
+## Remarks
+
 Check the number of parameters in your `get` and `set` methods against property dimensions.
 
 - The number of parameters for the `get` method must equal the number of dimensions of the property or be zero for nonindexed properties.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md
@@ -10,10 +10,14 @@ ms.assetid: 3c322482-c79e-4197-a578-2ad9bc379d1a
 
 > access level less restrictive than 'construct'
 
+## Remarks
+
 A property accessor method (get or set) cannot have less restrictive access than the access specified on the property itself.  Similarly, for event accessor methods.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md) and [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3908:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md
@@ -10,10 +10,14 @@ ms.assetid: 0a443132-e53f-42dc-a58b-f086da3e7bfd
 
 > aWinRT or managed event declaration must occur in a WinRT or managed type
 
+## Remarks
+
 A Windows Runtime event or managed event was declared in a native type. To fix this error, declare events in Windows Runtime types or managed types.
 
 For more information, see [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3909 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md
@@ -10,10 +10,14 @@ ms.assetid: cfcbe620-b463-463b-95ea-2d60ad33ebb5
 
 > 'event': must define member 'method'
 
+## Remarks
+
 An event was defined, but did not contain the specified, required accessor method.
 
 For more information, see [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3910:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md
@@ -10,10 +10,14 @@ ms.assetid: b786da59-0e99-479d-bc0d-551126e940f2
 
 > 'event_accessor_method': function must have type 'signature'
 
+## Remarks
+
 An event's accessor method was not properly declared.
 
 For more information, see [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3911:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md
@@ -10,10 +10,14 @@ ms.assetid: 674e050c-11fb-4db1-8bdf-a3e95b41161d
 
 > 'event': type of event must be a delegate type
 
+## Remarks
+
 An event was declared but was not of the proper type.
 
 For more information, see [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3912:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md
@@ -10,10 +10,14 @@ ms.assetid: a678bfce-9524-470d-9f23-7d08ecb972c8
 
 > default property must be indexed
 
+## Remarks
+
 A default property was defined incorrectly.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3913:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md
@@ -10,6 +10,8 @@ ms.assetid: 8f3190e6-ee50-4916-9ecc-3b8748b2e1e7
 
 > a default property cannot be static
 
+## Remarks
+
 A default property was declared incorrectly.  For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md
@@ -10,6 +10,8 @@ ms.assetid: 2b0a5e5f-3aec-4a4b-9157-233031817084
 
 > 'type' has no default indexed property (class indexer)
 
+## Remarks
+
 A type does not have a default, indexed property.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md
@@ -10,6 +10,8 @@ ms.assetid: a24cd0c9-262f-46e5-9488-1c01f945933d
 
 > '*property*': obsolete construct declaration style
 
+## Remarks
+
 A property or event definition used syntax from a version before Visual Studio 2005.
 
 For more information, see [property](../../extensions/property-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md
@@ -10,6 +10,8 @@ ms.assetid: a8b3a90a-3fe1-4244-a5ff-a31cdae97d98
 
 > usage requires 'member' to be a data member
 
+## Remarks
+
 C3918 can occur for several reasons related to events.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md
@@ -10,10 +10,14 @@ ms.assetid: 5f8eddda-d751-478b-930d-e18f7191ddfb
 
 > 'event_method': function must have type 'type'
 
+## Remarks
+
 An event accessor method was not declared correctly.
 
 For more information about events, see [event](../../extensions/event-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3919:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md
@@ -10,8 +10,12 @@ ms.assetid: 66e91f28-ed82-4ce2-bf22-c0c74905b1ed
 
 > 'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator  Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics
 
+## Remarks
+
 The Windows Runtime and CLR do not support the postfix operator and user-defined postfix operators are not allowed.  You can define a prefix operator and the prefix operator will be used for both pre- and post-increment operations.
 
+## Example
+
 The following sample generates C3920 and shows how to fix it:
 
 ```cpp
