Add "Remarks" and "Example" headings for error references in range [C3621, C3660]

Rageking8 · web-flow · commit aa5e410614ae · 2025-08-21T21:06:38.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md
@@ -10,6 +10,8 @@ ms.assetid: 02836f78-0cf2-4947-b87e-710187d81014
 
 > 'class' : a class declared as 'keyword' cannot be instantiated
 
+## Remarks
+
 An attempt was made to instantiate a class marked as [abstract](../../extensions/abstract-cpp-component-extensions.md). A class marked as **`abstract`** can be a base class, but it cannot be instantiated.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md
@@ -10,8 +10,12 @@ ms.assetid: a0341b45-062a-4f67-beb9-ba74201ed1ed
 
 > 'variable': bit fields are not supported in managed or WinRT types
 
+## Remarks
+
 The use of bit fields is not permitted on variables in a managed or WinRT class.
 
+## Example
+
 The following sample generates C3623:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md
@@ -10,6 +10,8 @@ ms.assetid: eaac6a4f-eb11-4e4d-ab12-124ba995c5cf
 
 > 'type': use of this type requires a reference to assembly 'assembly'
 
+## Remarks
+
 An assembly (reference) needed to compile your code was not specified; pass the assembly to the [#using](../../preprocessor/hash-using-directive-cpp.md) directive.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md
@@ -10,6 +10,8 @@ ms.assetid: fdf49f21-d6b1-42f4-9eec-23b04ae8b4aa
 
 > 'native_type': a native type cannot derive from a managed or WinRT type 'type'
 
+## Remarks
+
 A native class cannot inherit from a managed or WinRT class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md
@@ -10,8 +10,12 @@ ms.assetid: 43926e2b-1ba9-4a43-9343-c58449cbb336
 
 > 'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates
 
+## Remarks
+
 A keyword was used incorrectly.
 
+## Example
+
 The following sample generates C3626:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md
@@ -10,4 +10,6 @@ ms.assetid: 905ad0a0-8c49-4187-b66e-b375f5a1fae5
 
 > Only a value type can be boxed
 
+## Remarks
+
 Only value classes can be boxed.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md
@@ -10,8 +10,12 @@ ms.assetid: 0ff5a4a4-fcc9-47a0-a4d8-8af9cf2815f6
 
 > 'base class' : managed or WinRTclasses only support public inheritance
 
+## Remarks
+
 An attempt was made to use a managed or WinRT class as a [private](../../cpp/private-cpp.md) or [protected](../../cpp/protected-cpp.md) base class. A managed or WinRT class can only be used as a base class with [public](../../cpp/public-cpp.md) access.
 
+## Example
+
 The following sample generates C3628 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md
@@ -10,4 +10,6 @@ ms.assetid: 865626a9-98cc-465d-acde-44d4574c019a
 
 > error when processing the token '*token*'
 
+## Remarks
+
 A token in source code couldn't be processed. This error is obsolete in Visual Studio 2022.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md
@@ -10,6 +10,8 @@ ms.assetid: 88cbd2d5-6fef-4940-be34-d8cbe816d3da
 
 > 'function': cannot overload managed or WinRT events
 
+## Remarks
+
 A managed or WinRT event cannot be overloaded.
 
 C3631 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md
@@ -10,6 +10,8 @@ ms.assetid: a04e3217-f5a1-4461-a1db-d69fd096d468
 
 > 'event': illegal style of event for construct
 
+## Remarks
+
 [__event](../../cpp/event.md) declarations are not valid in all constructs.
 
 C3632 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md
@@ -10,6 +10,8 @@ ms.assetid: 7d65babf-2191-4d67-a69f-f5c4c2ddf946
 
 > cannot define 'member' as a member of managed 'type'
 
+## Remarks
+
 CLR reference class data members cannot be of a non-POD C++ type.  You can only instantiate a POD native type in a CLR type.  For example, a POD type cannot contain a copy constructor or an assignment operator.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md
@@ -10,6 +10,8 @@ ms.assetid: fd09f10c-f863-483b-9756-71c16b760b02
 
 > 'function' : cannot define an abstract method of a managed or WinRTclass
 
+## Remarks
+
 An abstract method can be declared in a managed or WinRT class, but it cannot be defined.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md
@@ -10,8 +10,12 @@ ms.assetid: 72391377-8519-43d9-870a-73a6423deb74
 
 > 'function' : a friend function definition cannot be a specialization of a function type
 
+## Remarks
+
 A friend function was defined incorrectly for a template or generic.
 
+## Examples
+
 The following sample generates C3637:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md
@@ -10,10 +10,14 @@ ms.assetid: 8d8bc5ca-75aa-480e-b6b6-3178fab51b1d
 
 > 'operator' : the standard boxing and unboxing conversion operators cannot be redefined
 
+## Remarks
+
 The compiler defines a conversion operator for each managed class to support implicit boxing. This operator cannot be redefined.
 
 For more information, see [Implicit Boxing](../../extensions/boxing-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3638:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md
@@ -10,8 +10,12 @@ ms.assetid: fcc56894-0f98-48af-8561-3bf7c7b2b93f
 
 > 'member' : a referenced or virtual member function of a local class must be defined
 
+## Remarks
+
 The compiler requires certain functions to be defined.
 
+## Example
+
 The following sample generates C3640:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md
@@ -10,12 +10,16 @@ ms.assetid: 429790c2-9614-4d85-b31c-687c8d8f83ff
 
 > 'return_type/args' : cannot call a function with __clrcall calling convention from native code
 
+## Remarks
+
 A function that is marked with the [__clrcall](../../cpp/clrcall.md) calling convention cannot be called from native (unmanaged) code.
 
 *return_type/args* is either the name of the function or the type of the `__clrcall` function you are trying to call.  A type is used when you're calling through a function-pointer.
 
 To call a managed function from a native context, you can add a "wrapper" function that will call the `__clrcall` function. Or, you can use the CLR marshalling mechanism; see [How to: Marshal Function Pointers Using PInvoke](../../dotnet/how-to-marshal-function-pointers-using-pinvoke.md) for more information.
 
+## Example
+
 The following sample generates C3642:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md
@@ -10,8 +10,12 @@ ms.assetid: 2e3f6c41-3ec5-4a01-82bc-f11b61ebe68e
 
 > 'function' : cannot compile the function to generate managed code
 
+## Remarks
+
 The presence of some keywords in a function will cause the function to be compiled to native.
 
+## Example
+
 The following sample generates C3644:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md
@@ -10,6 +10,8 @@ ms.assetid: 346da528-ae86-4cd0-9654-f41bee26ac0d
 
 > 'function' : __clrcall cannot be used on functions compiled to native code
 
+## Remarks
+
 The presence of some keywords in a function will cause the function to be compiled to native.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md
@@ -10,6 +10,8 @@ ms.assetid: 5d042989-41cb-4cd0-aa50-976b70146aaf
 
 > this explicit override syntax requires /clr:oldSyntax
 
+## Remarks
+
 When compiling for the latest managed syntax, the compiler found explicit override syntax for previous versions that is no longer supported.
 
 For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md
@@ -10,10 +10,14 @@ ms.assetid: ca4d8de4-b027-4d13-9b9f-03ca62905c33
 
 > 'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class
 
+## Remarks
+
 An attempt was made to perform an explicit override on a member that was not virtual.
 
 For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3650:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md
@@ -10,10 +10,14 @@ ms.assetid: a03e692e-c219-4654-9827-8415cfa5a22d
 
 > 'member' : cannot be used as an explicit override, must be a member of a base class
 
+## Remarks
+
 An explicit override was specified, but the function being overridden was in a type that is not a base type.
 
 For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3651:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md
@@ -10,8 +10,12 @@ ms.assetid: 15d68737-177e-41f1-80e0-7c3e2afdf0fc
 
 > 'override' : a function that explicitly overrides must be virtual
 
+## Remarks
+
 A function that does an explicit override must be virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3652:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md
@@ -10,8 +10,12 @@ ms.assetid: 316549d7-f7ef-4578-a2ba-57adc8aac527
 
 > 'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator?
 
+## Remarks
+
 An explicit override specified a function that was not found in any interface. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3653:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md
@@ -10,8 +10,12 @@ ms.assetid: 57d96e3f-6bbb-4eaa-934b-26c23b4ceb2e
 
 > 'text' : syntax error in explicit override
 
+## Remarks
+
 An unexpected string was in an explicit override. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3654:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md
@@ -10,8 +10,12 @@ ms.assetid: 724919ab-2915-4b61-8794-44648e162d62
 
 > 'function' : function already explicitly overridden
 
+## Remarks
+
 A function can only be explicitly overridden once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3655:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md
@@ -10,8 +10,12 @@ ms.assetid: 88965d85-73b0-4b35-8020-0650c9c94cd8
 
 > 'override' : override specifier cannot be repeated
 
+## Remarks
+
 An explicit override keyword can only be specified once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
+## Example
+
 The following sample generates C3656:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md
@@ -10,6 +10,8 @@ ms.assetid: 89a28a18-4c17-43a1-bda6-deb52c32d203
 
 > destructors cannot explicitly override or be explicitly overridden
 
+## Remarks
+
 Destructors or finalizers cannot be explicitly overridden. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md).
 
 ## Example
