Add "Remarks" and "Example" headings for error references in range [C3131, C3160]

Rageking8 · web-flow · commit 6f9458eb6373 · 2025-08-14T22:39:18.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md
@@ -10,8 +10,12 @@ ms.assetid: 38f20fac-83c9-4cd9-b7b5-74ca8f650ea6
 
 > project must have a 'module' attribute with a 'name' property
 
+## Remarks
+
 The [module](../../windows/attributes/module-cpp.md) attribute must have a name parameter.
 
+## Example
+
 The following sample generates C3131:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md
@@ -10,8 +10,12 @@ ms.assetid: d54a3d12-336a-4ed0-ad4e-43cddac33b5e
 
 > 'function-parameter' : parameter arrays can only be applied to a formal argument of type 'single-dimensional managed array'
 
+## Remarks
+
 The <xref:System.ParamArrayAttribute> attribute was applied to a parameter that was not a single-dimension array.
 
+## Example
+
 The following sample generates C3132:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md
@@ -10,6 +10,8 @@ ms.assetid: 4a709405-b67b-4061-8a2a-19fa5fb34a2a
 
 > Attributes cannot be applied to C++ varargs
 
+## Remarks
+
 An attribute was applied incorrectly. Attributes can not be applied to an ellipsis representing variable arguments.
 
 For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md
@@ -10,6 +10,8 @@ ms.assetid: f887e4d2-7740-49e4-9972-7edceb8fa77b
 
 > 'value' : value of attribute argument 'attribute' does not have valid type 'type'
 
+## Remarks
+
 A syntax error was detected when a value was assigned to an attribute.
 
 ## See also
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md
@@ -10,4 +10,6 @@ ms.assetid: e92ee007-5a26-47f4-8ef4-339f2d9528d1
 
 > 'property' : a property cannot have a 'const' or 'volatile' type
 
+## Remarks
+
 The [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) keywords are not permitted on properties.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md
@@ -10,8 +10,12 @@ ms.assetid: c77103cd-00f7-408e-b74b-4f8562039d31
 
 > 'interface' : a COM interface can only inherit from another COM interface, 'interface' is not a COM interface
 
+## Remarks
+
 An interface to which you applied an [interface attribute](../../windows/attributes/interface-attributes.md) inherits from an interface that is not a COM interface. A COM interface ultimately inherits from `IUnknown`. Any interface preceded by an interface attribute is a COM interface.
 
+## Example
+
 The following example generates C3136:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md
@@ -10,8 +10,12 @@ ms.assetid: 70bb1313-2e87-43ed-a0d8-33fa6ff475e4
 
 > 'property' : a property cannot be initialized
 
+## Remarks
+
 A property cannot be initialized, for example, in a constructor's initialization list.
 
+## Example
+
 The following example generates C3137:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md
@@ -10,8 +10,12 @@ ms.assetid: 364ee9e8-9358-410e-bd35-9c4a226a3753
 
 > 'interface' : a 'attribute' interface must inherit from IDispatch, or from an interface that inherits from IDispatch
 
+## Remarks
+
 An interface with the [dual](../../windows/attributes/dual.md) or [dispinterface](../../windows/attributes/dispinterface.md) attributes does not have `IDispatch` as a direct or indirect base interface.
 
+## Example
+
 The following example generates C3138:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md
@@ -10,7 +10,13 @@ ms.assetid: 95c92263-10ac-4ff3-b385-6312dd92adbc
 
 > 'struct' : cannot export a UDT without members
 
-You attempted to apply the [export](../../windows/attributes/export.md) attribute to an empty UDT (user-defined type). For example:
+## Remarks
+
+You attempted to apply the [export](../../windows/attributes/export.md) attribute to an empty UDT (user-defined type).
+
+## Example
+
+For example:
 
 ```cpp
 // C3139.cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md
@@ -10,8 +10,12 @@ ms.assetid: 122f8943-fac3-4db8-a3a8-2c5d19233de6
 
 > cannot have multiple 'module' attributes in the same compilation unit
 
+## Remarks
+
 The [module](../../windows/attributes/module-cpp.md) attribute can only be defined once per project.
 
+## Example
+
 The following sample generates C3140:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md
@@ -10,8 +10,12 @@ ms.assetid: b4fd65c3-50cc-46cd-8de0-6a6d24cb9cda
 
 > 'interface_name' : interfaces only support public inheritance
 
+## Remarks
+
 Interfaces defined with the [interface (or __interface)](../../cpp/interface.md) keyword only support public inheritance.
 
+## Example
+
 The following sample generates C3141:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md
@@ -10,8 +10,12 @@ ms.assetid: 795137ad-d00a-4a9c-9665-0cd8bfb5da8b
 
 > 'property_name' : you cannot take the address of a property
 
+## Remarks
+
 The address of a property is not available to the developer.
 
+## Example
+
 The following sample generates C3142:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md
@@ -10,8 +10,12 @@ ms.assetid: f165c874-0f51-45c7-85e8-ebe321cbc168
 
 > 'object' : global or static variable may not have managed or WinRT type 'type'
 
+## Remarks
+
 You can only define CLR or WinRT objects within function scope.
 
+## Examples
+
 The following sample generates C3145 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md
@@ -10,12 +10,16 @@ ms.assetid: cf6e2616-2f06-46da-8a8a-d449cb481c51
 
 > 'type' : cannot use this type here without a top-level 'char'
 
+## Remarks
+
 A declaration was not specified correctly.
 
 For example, you may have defined a CLR type at global scope and tried to create a variable of the type as part of the definition. Because global variables of CLR types are not allowed, the compiler will generate C3149.
 
 To resolve this error, declare variables of CLR types inside a function or type definition.
 
+## Examples
+
 The following sample generates C3149:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md
@@ -10,6 +10,8 @@ ms.assetid: c1ff28f5-52fe-4fd4-81d0-2e0ad8548631
 
 > 'element' : 'attribute' can only be applied to a class, interface, array or pointer
 
+## Remarks
+
 **`__gc`** can only be used on a class, interface, or array.
 
 C3150 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md
@@ -10,8 +10,12 @@ ms.assetid: 4ee6e2cd-5d19-4b73-833d-765c35797e4b
 
 > 'construct' : 'keyword' can only be applied to a class, struct, or virtual member function
 
+## Remarks
+
 Certain keywords can only be applied to a C++ class.
 
+## Example
+
 The following sample generates C3152 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md
@@ -10,8 +10,12 @@ ms.assetid: d775d97e-2480-484f-81f1-88406b10f947
 
 > 'interface' : you cannot create an instance of an interface
 
+## Remarks
+
 An interface cannot be instantiated. To use the members of an interface, derive a class from the interface, implement the interface members, and then use the members.
 
+## Example
+
 The following sample generates C3153:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md
@@ -10,6 +10,8 @@ ms.assetid: 78005c74-eaaf-4ac2-88ae-6c25d01a302a
 
 > Expected ',' before ellipsis. Non-comma separated ellipsis not supported on parameter array functions.
 
+## Remarks
+
 A variable argument function was not declared correctly.
 
 For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extensions/variable-argument-lists-dot-dot-dot-cpp-cli.md).
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md
@@ -10,6 +10,8 @@ ms.assetid: b04a42e1-64e7-40f8-81fe-c7945348b2cf
 
 > attributes are not allowed in a property indexer
 
+## Remarks
+
 An indexed 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-c3156.md b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md
@@ -10,6 +10,8 @@ ms.assetid: 1876da78-b94e-4af7-9795-28f72b209b3e
 
 > 'class' : you cannot have a local definition of a managed or WinRT type
 
+## Remarks
+
 A function cannot contain the definition, or declaration, of a managed or WinRT class, struct, or interface.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md
@@ -10,4 +10,6 @@ ms.assetid: fe94d97f-612e-4729-8b2b-b057d84822a1
 
 > ParamArray attribute can only be applied to the last parameter
 
+## Remarks
+
 The <xref:System.ParamArrayAttribute> attribute was applied to the wrong parameter.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md
@@ -10,6 +10,8 @@ ms.assetid: e115cc76-0021-4568-95fd-61a324c41a85
 
 > 'pointer' : array of pointers to value type cannot be declared
 
+## Remarks
+
 An array of pointers to a value type cannot be declared.
 
 C3159 is only reachable using the obsolete compiler option **/clr:oldSyntax**.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md
@@ -10,8 +10,12 @@ ms.assetid: a250c433-8adf-43b9-8dee-c3794e09b0a5
 
 > 'pointer' : a data member of a managed or WinRT class cannot have this type
 
+## Remarks
+
 Interior garbage collection pointers may point to the interior of a managed or WinRT class. Because they are slower than whole-object pointers and require special handling by the garbage collector, you cannot declare interior managed pointers as members of a class.
 
+## Example
+
 The following sample generates C3160:
 
 ```cpp
