Add "Remarks" and "Example" headings for error references in range [C3801, C3850]

Rageking8 · web-flow · commit 31ce480d1fa5 · 2025-08-23T21:08:50.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md
@@ -10,8 +10,12 @@ ms.assetid: bad5fb9a-ed9a-4c15-96e7-cf06e200a50d
 
 > 'property': property has a type that is incompatible with one of its accessors 'accessor'
 
+## Remarks
+
 The type of a property defined with [property](../../cpp/property-cpp.md) does not match the return type for one of its accessor functions.
 
+## Example
+
 The following sample generates C3803:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md
@@ -10,6 +10,8 @@ ms.assetid: 7c4cda28-ec96-4d04-937b-36dbd9944722
 
 > 'property_accessor': the accessor methods for a property must either be all static or all non-static
 
+## Remarks
+
 When defining a non-trivial property, the accessor functions can be either static or instance, but not both.
 
 See [property](../../extensions/property-cpp-component-extensions.md) for more information.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md
@@ -10,4 +10,6 @@ ms.assetid: 166bbc35-5488-46b4-8e4c-9cd26ee5644e
 
 > 'token' : unexpected token, expected either '}' or an identifier
 
+## Remarks
+
 When defining a property, an invalid token was encountered. Remove the invalid token.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md
@@ -10,6 +10,8 @@ ms.assetid: 7e2b0aab-8c61-4e71-b9c1-fcaeb6a1b5ea
 
 > 'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed
 
+## Remarks
+
 A type that derived from <xref:System.Runtime.InteropServices.ComImportAttribute> can only implement an interface.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md
@@ -10,8 +10,12 @@ ms.assetid: 37eca584-c20c-464e-8e45-a987214b7ce4
 
 > 'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces
 
+## Remarks
+
 Managed types and Windows Runtime types do not allow friends. To fix this error, do not declare friends inside managed or Windows Runtime types.
 
+## Example
+
 The following sample generates C3809:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md
@@ -10,6 +10,8 @@ ms.assetid: 326ac706-9a5f-4851-b9d2-b90c64c75532
 
 > 'property' must be the first token in a property declaration
 
+## Remarks
+
 When declaring a property, the `__property` keyword must be the first token on the line.
 
 C3812 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md
@@ -10,6 +10,8 @@ ms.assetid: ffdbc489-71bf-4cd6-988c-f824c9ab3ceb
 
 > a property declaration can only appear within the definition of a managed or WinRT type
 
+## Remarks
+
 A [property](../../dotnet/how-to-use-properties-in-cpp-cli.md) can only be declared within a managed or Windows Runtime type. Native types do not support the **`property`** keyword.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md
@@ -10,6 +10,8 @@ ms.assetid: c5a3b404-6341-4fd3-92af-152b404c4dde
 
 > return type of method 'get_accessor' must match type of the last parameter of a setter
 
+## Remarks
+
 When declaring properties, the return value of the `get_accessor` method must match the last parameter in the declaration of the set accessor method.
 
 C3815 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md
@@ -10,8 +10,12 @@ ms.assetid: 2e52cc7f-e31c-41a3-8d6f-9f5fab3648c0
 
 > 'declaration' was previously declared or defined with a different managed or WinRTmodifier
 
+## Remarks
+
 A forward declaration and an actual declaration require that there be no conflicts or inconsistencies in the declaration of attributes.
 
+## Example
+
 The following sample generates C3816 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md
@@ -10,6 +10,8 @@ ms.assetid: c6dbb57a-c65e-4040-8dd2-85bd9d4fd337
 
 > 'declaration' : property can only be applied to a function
 
+## Remarks
+
 The **`property`** keyword can only be a applied to a function definition.
 
 C3817 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md
@@ -10,6 +10,8 @@ ms.assetid: f9502f6a-0690-4135-ab88-cc97cf490f5c
 
 > array property declaration 'property1' shall not overload an index property 'property2'
 
+## Remarks
+
 An overload is not possible for properties when one is an indexer and the other is an array property.
 
 C3818 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md
@@ -10,6 +10,8 @@ ms.assetid: 2b327c7a-5faf-443c-ae82-944fae25b4df
 
 > 'function': managed type or function cannot be used in an unmanaged function
 
+## Remarks
+
 Functions with inline assembly or [setjmp](../../c-runtime-library/reference/setjmp.md) cannot contain value types or managed classes. To fix this error, remove the inline assembly and `setjmp` or remove the managed objects.
 
 C3821 can also occur if you try to use automatic storage in a vararg function.  For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extensions/variable-argument-lists-dot-dot-dot-cpp-cli.md) and [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md
@@ -10,6 +10,8 @@ ms.assetid: b6c6adf1-0a29-401c-a06e-616fd50d4c37
 
 > 'member': this type cannot appear in this context (function parameter, return type, or a static member)
 
+## Remarks
+
 Pinning pointers cannot be function parameters, return types, or declared **`static`**.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md
@@ -10,6 +10,8 @@ ms.assetid: 18e204a1-f26e-42c6-8d74-2b49cc95f940
 
 > 'class': a managed or WinRTclass can only support managed or WinRTevents
 
+## Remarks
+
 Only .NET events are supported in managed classes. Only Windows Runtime events are supported in Windows Runtime classes. To fix this error in managed code, change type parameter of `event_source` and `event_receiver` from `native` to `managed`. Alternatively, remove the attribute.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md
@@ -10,8 +10,12 @@ ms.assetid: 8d9cee75-9504-4bc8-88b6-2413618a3f45
 
 > 'object type': placement arguments not allowed while creating instances of managed or WinRTclasses
 
+## Remarks
+
 When creating an object of a managed type or Windows Runtime type, you cannot use the placement form of operator [ref new, gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md) or [new](../../cpp/new-operator-cpp.md).
 
+## Example
+
 The following sample generates C3828 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md
@@ -10,6 +10,8 @@ ms.assetid: c9798f88-5001-4067-9fb1-09957ddc6fa8
 
 > 'type1': cannot inherit from 'type2', value types can only inherit from interface classes
 
+## Remarks
+
 A value type cannot inherit a base 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-c3831.md b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md
@@ -10,6 +10,8 @@ ms.assetid: a125d8dc-b75a-4ea0-b6c7-fe7b119dba25
 
 > 'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer
 
+## Remarks
+
 [pin_ptr (C++/CLI)](../../extensions/pin-ptr-cpp-cli.md) was used incorrectly.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md
@@ -10,4 +10,6 @@ ms.assetid: 9a41df82-42e1-4908-958c-76cff9235de0
 
 > 'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier
 
+## Remarks
+
 Explicit information supplied with the `ptrsize` attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive did not agree with what the compiler found in the type library.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md
@@ -10,8 +10,12 @@ ms.assetid: 8152be53-e01e-48cd-9eef-9de38723664c
 
 > 'type' : invalid target type for pointer_type
 
+## Remarks
+
 An [interior_ptr](../../extensions/interior-ptr-cpp-cli.md) or [pin_ptr](../../extensions/pin-ptr-cpp-cli.md) was declared incorrectly.
 
+## Examples
+
 The following sample generates C3833:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md
@@ -10,6 +10,8 @@ ms.assetid: 059e0dc4-300b-4e74-b6c2-41a57831fe2a
 
 > illegal explicit cast to a pinning pointer; use a pinned local variable instead
 
+## Remarks
+
 Explicit casts to a pinned pointer are not allowed.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md
@@ -10,6 +10,8 @@ ms.assetid: 254f851b-7b7d-4c34-a740-fcf72f6a636a
 
 > static constructor is not allowed to have a member initializer list
 
+## Remarks
+
 A managed class cannot have a static constructor that also has a member initialization list. Static class constructors are called by the common language runtime to do class initialization, initializing static data members.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md
@@ -10,6 +10,8 @@ ms.assetid: d6f470c2-131a-4a8c-843a-254acd43da83
 
 > cannot explicitly inherit from 'type'
 
+## Remarks
+
 The specified `type` cannot act as a base class in any class.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md
@@ -10,8 +10,12 @@ ms.assetid: 0957faff-1e9f-439b-876b-85bd8d2c578d
 
 > cannot change alignment in a managed or WinRT type
 
+## Remarks
+
 Alignment of variables in managed or Windows Runtime types is controlled by the CLR or Windows Runtime and cannot be modified with [align](../../cpp/align-cpp.md).
 
+## Example
+
 The following sample generates C3839:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md
@@ -10,8 +10,12 @@ ms.assetid: 41a1a44a-c618-40a2-8d26-7da27d14095d
 
 > 'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported
 
+## Remarks
+
 [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) are not supported on member functions of Windows Runtime or managed types.
 
+## Example
+
 The following sample generates C3842:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md
@@ -10,6 +10,8 @@ ms.assetid: c470f8a5-106b-4efb-b8dc-e1319e04130f
 
 > 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1'
 
+## Remarks
+
 A symbol could not be imported from a referenced assembly because it was previously imported from a referenced assembly.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md
@@ -10,8 +10,12 @@ ms.assetid: 32d3ccef-01ec-4f8b-bbff-fb9b1a76b4c4
 
 > expression having type 'type' would lose some const-volatile qualifiers in order to call 'function'
 
+## Remarks
+
 A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications.
 
+## Example
+
 The following samples generate C3848:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md
@@ -10,10 +10,14 @@ ms.assetid: 5347140e-1a81-4841-98c0-b63d98264b64
 
 > function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads
 
+## Remarks
+
 A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications.
 
 To fix this error, provide an appropriate member function. You cannot execute a conversion on a const or volatile qualified object when the conversion causes loss of qualification. You can gain qualifiers but you cannot lose qualifiers in a conversion.
 
+## Example
+
 The following samples generate C3849:
 
 ```cpp
