Add "Remarks" and "Example" headings for error references in range [C3161, C3190]

Rageking8 · web-flow · commit 6a07aa00f3eb · 2025-08-15T17:11:39.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md
@@ -10,6 +10,8 @@ ms.assetid: 1fe2be85-a343-487b-8476-bf9e257eb29d
 
 > 'interface' : nesting class, struct, union or interface in an interface is illegal; nesting interface in a class, struct or union is illegal
 
+## Remarks
+
 An [__interface](../../cpp/interface.md) can only appear at global scope or within a namespace. A class, struct, or union cannot appear in an interface.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md
@@ -10,6 +10,8 @@ ms.assetid: 0d4c4a24-1456-4191-b7d8-c38cb7b17c32
 
 > 'type' : a reference type which has a destructor cannot be used as the type of static data member 'member'
 
+## Remarks
+
 The common language runtime cannot know when to run a user-defined destructor when the class also contains static member function.
 
 A destructor will never be run unless the object is deleted explicitly.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md
@@ -10,6 +10,8 @@ ms.assetid: 17dcafa3-f416-4e04-a232-f9569218ba75
 
 > '*construct*': attributes inconsistent with previous declaration
 
+## Remarks
+
 The attribute(s) that are applied to a definition conflict with the attribute(s) that are applied to a declaration.
 
 One way to resolve C3163 is to eliminate attributes on the forward declaration. Any attributes on a forward declaration should be less than the attributes on the definition or, at most, equal to them.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3166.md b/docs/error-messages/compiler-errors-2/compiler-error-c3166.md
@@ -10,6 +10,8 @@ ms.assetid: ec3e330d-c15d-4158-8268-09101486c566
 
 > 'pointer' : cannot declare a pointer to an interior __gc pointer as a member of 'type'
 
+## Remarks
+
 The compiler found an invalid pointer declaration (a **`__nogc`** pointer to a **`__gc`** pointer.).
 
 C3166 is only reachable using the obsolete compiler option **`/clr:oldSyntax`**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md
@@ -10,4 +10,6 @@ ms.assetid: 58c25fe7-8562-4a18-ad3f-487f081ff173
 
 > Unable to initialize .NET Framework: make sure it is installed
 
+## Remarks
+
 The .NET Framework is not installed on this computer; install the .NET Framework.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md
@@ -10,8 +10,12 @@ ms.assetid: 4c36fcfb-c351-48ff-b4eb-78d2aa1b4d55
 
 > 'type' : illegal underlying type for enum
 
+## Remarks
+
 The underlying type you specified for the **`enum`** type was not valid. The underlying type must be an integral C++ type or a corresponding CLR type.
 
+## Example
+
 The following sample generates C3168:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md
@@ -10,10 +10,14 @@ ms.assetid: ca9a59d6-7df3-42f0-b028-c09d0af3ac2a
 
 > cannot have different module identifiers in a project
 
+## Remarks
+
 [module](../../windows/attributes/module-cpp.md) attributes with different names were found in two of the files in a compilation. Only one unique `module` attribute can be specified per compilation.
 
 Identical `module` attributes can be specified in more than one source code file.
 
+## Example
+
 For example, if the following module attributes were found:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md
@@ -10,10 +10,14 @@ ms.assetid: 1ce26997-7ef1-4c9f-84da-003ea1a4251e
 
 > 'module': cannot specify different module attributes in a project
 
+## Remarks
+
 [module](../../windows/attributes/module-cpp.md) attributes with different parameter lists were found in two of the files in a compilation. Only one unique `module` attribute can be specified per compilation.
 
 Identical `module` attributes can be specified in more than one source code file.
 
+## Example
+
 For example, if the following `module` attributes were found:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md
@@ -10,10 +10,14 @@ ms.assetid: 1834e2fd-6036-4c33-aff2-b51bc7c99441
 
 > 'module_name': cannot specify different idl_module attributes in a project
 
+## Remarks
+
 [idl_module](../../windows/attributes/idl-module.md) attributes with the same name but different `dllname` or `version` parameters were found in two of the files in a compilation. Only one unique `idl_module` attribute can be specified per compilation.
 
 Identical `idl_module` attributes can be specified in more than one source code file.
 
+## Example
+
 For example, if the following `idl_module` attributes were found:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md
@@ -10,6 +10,8 @@ ms.assetid: edf79e10-e8cf-4f76-8d33-ab9d05e974e9
 
 > version mismatch in idl merge
 
+## Remarks
+
 This error occurs when an object file contains embedded idl that was generated with a previous version of the compiler. The compiler encodes a version number to ensure that the same compiler used to generate the idl content that is embedded in the .obj files is also the same compiler used to merge the embedded idl.
 
 Update your Visual C++ installation so that all tools are from the latest released version.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md
@@ -10,8 +10,12 @@ ms.assetid: fe6b3b5a-8196-485f-a45f-0b2e51df4086
 
 > module attribute was not specified
 
+## Remarks
+
 A program that uses Visual C++ attributes did not also use the [module](../../windows/attributes/module-cpp.md) attribute, which is required in any program that uses attributes.
 
+## Example
+
 The following sample generates C3174:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md
@@ -10,8 +10,12 @@ ms.assetid: 3f19d513-a05a-4b6c-806f-276fe5c36b90
 
 > 'function1' : cannot call a method of a managed type from unmanaged function 'function2'
 
+## Remarks
+
 Unmanaged functions cannot call member functions of managed classes.
 
+## Example
+
 The following sample generates C3175:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md
@@ -10,6 +10,8 @@ ms.assetid: 6cc8d602-8e15-47a7-b1b5-e93e5d50e271
 
 > 'type' : cannot declare local value type
 
+## Remarks
+
 A class can only be declared as a value type at global scope.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md
@@ -10,8 +10,12 @@ ms.assetid: 60d7e41b-25fd-48ac-8b79-830c062f4dcd
 
 > an unnamed managed or WinRT type is not allowed
 
+## Remarks
+
 All CLR and WinRT classes and structs must have names.
 
+## Example
+
 The following sample generates C3179 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md
@@ -10,6 +10,8 @@ ms.assetid: 5281f583-7df7-418a-8507-d4da67ed6572
 
 > 'type name' : name exceeds meta-data limit of 'limit' characters
 
+## Remarks
+
 The compiler truncated the name for a managed type in metadata. The truncation will make the type unusable with the `#using` directive (or the equivalent in another language).
 
 The type-name limit includes any namespace qualifications.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md
@@ -10,10 +10,14 @@ ms.assetid: 5d450f8b-6cef-4452-a0c4-2076e967451d
 
 > 'type' : invalid operand for operator
 
+## Remarks
+
 An invalid parameter was passed to the [typeid](../../extensions/typeid-cpp-component-extensions.md) operator. The parameter must be a managed type.
 
 Note that the compiler uses aliases for native types that map to types in the common language runtime.
 
+## Example
+
 The following sample generates C3181:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md
@@ -10,8 +10,12 @@ ms.assetid: f3681266-308e-4990-a979-8eef8920e186
 
 > 'class' : a member using-declaration or access declaration is illegal within a managed or WinRTtype
 
+## Remarks
+
 A [using](../../cpp/using-declaration.md) declaration is invalid within all forms of managed classes.
 
+## Example
+
 The following sample generates C3182 and shows how to fix it.
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md
@@ -10,8 +10,12 @@ ms.assetid: dbd0f020-c739-43c9-947e-9ce21537331b
 
 > cannot define unnamed class, struct or union inside of managed or WinRT type 'type'
 
+## Remarks
+
 A type that is embedded in a managed or WinRT type must be named.
 
+## Example
+
 The following sample generates C3183:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C3185"]
 
 > 'typeid' used on managed or WinRT type 'type', use 'operator' instead
 
+## Remarks
+
 You cannot apply the [typeid](../../cpp/typeid-operator.md) operator to a managed or WinRT type; use [typeid](../../extensions/typeid-cpp-component-extensions.md) instead.
 
+## Example
+
 The following sample generates C3185 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md
@@ -10,10 +10,14 @@ ms.assetid: b254de79-931e-4a59-a9f4-1c690d90ca5e
 
 > 'typeid\<type abstract declarator>': this syntax is no longer supported, use ::typeid instead
 
+## Remarks
+
 An obsolete form of [typeid](../../extensions/typeid-cpp-component-extensions.md) was used, use the new form.
 
 This error is obsolete in Visual Studio 2022 and later versions.
 
+## Example
+
 The following sample generates C3189:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md
@@ -10,8 +10,12 @@ ms.assetid: 7c701afa-85a7-4f7a-8881-0662436ac244
 
 > 'instantiation' with the provided template arguments is not the explicit instantiation of any member function of 'type'
 
+## Remarks
+
 The compiler detected an attempt to make an explicit function instantiation; however, the provided type arguments do not match any of the possible functions.
 
+## Example
+
 The following sample generates C3190:
 
 ```cpp
