Add "Remarks" and "Example" headings for warning references in range [C4661, C4700]

Rageking8 · web-flow · commit df6e56d1dbbe · 2025-09-01T23:54:39.000+08:00
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md
@@ -10,6 +10,8 @@ ms.assetid: 72d8db01-5e6f-4794-8731-76107e8f064a
 
 > 'class': a sealed abstract class cannot have any instance members 'Test'
 
+## Remarks
+
 If a type is marked [sealed](../../extensions/sealed-cpp-component-extensions.md) and [abstract](../../extensions/abstract-cpp-component-extensions.md), it can only have static members.
 
 This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md).
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md
@@ -10,6 +10,8 @@ ms.assetid: 5ca122bb-34f3-43ee-a21f-95802cd515f7
 
 > '*class*': a sealed abstract class cannot have a base-class '*base_class*'
 
+## Remarks
+
 An abstract and sealed class cannot inherit from a reference type; a sealed and abstract class can neither implement the base class functions nor allow itself to be used as a base class.
 
 For more information, see [abstract](../../extensions/abstract-cpp-component-extensions.md), [sealed](../../extensions/sealed-cpp-component-extensions.md), and [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md).
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md
@@ -10,6 +10,8 @@ ms.assetid: 603bb8b7-356d-4eef-924b-64d769bac5bd
 
 > 'identifier' : no suitable definition provided for explicit template instantiation request
 
+## Remarks
+
 A member of the template class is not defined.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md
@@ -10,6 +10,8 @@ ms.assetid: 7efda273-d04a-47b7-ad65-ff1ff94b5ffc
 
 > explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2'
 
+## Remarks
+
 The specified template-class was declared, but not defined.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md
@@ -10,8 +10,12 @@ ms.assetid: 5d2b7fe0-4f0e-4cd6-b432-ca02c3d194ab
 
 > 'function' : no function template defined that matches forced instantiation
 
+## Remarks
+
 You cannot instantiate a function template that has not been declared.
 
+## Example
+
 The following sample will cause C4667:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md
@@ -10,8 +10,12 @@ ms.assetid: 97730679-e3dc-44d4-b2a8-aa65badc17f2
 
 > 'cast' : unsafe conversion: 'class' is a managed or WinRT type object
 
+## Remarks
+
 A cast contains a Windows Runtime or managed type. The compiler completes the cast by performing a bit-wise copy of one pointer to the other, but provides no other checking. To resolve this warning, do not cast classes containing managed members or Windows Runtime types.
 
+## Example
+
 The following sample generates C4669 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md
@@ -10,6 +10,8 @@ ms.assetid: 638dae0b-b82c-4865-9599-72630827ca09
 
 > 'method' should be declared 'static' and have exactly one parameter
 
+## Remarks
+
 The signature of a conversion operator was not correct. The method is not considered a user-defined conversion. For more information on defining operators, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md) and [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md
@@ -10,6 +10,8 @@ ms.assetid: a8d656a1-e2ff-4f8b-9028-201765131026
 
 > 'function': signature of non-private member contains assembly private type 'private_type'
 
+## Remarks
+
 A type that has public accessibility outside the assembly uses a type that has private access outside the assembly. A component that references the public assembly type will not be able to use the type member or members that reference the assembly private type.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md
@@ -10,6 +10,8 @@ ms.assetid: 0c588f34-595d-4e5c-9470-8723fca2cc06
 
 > base class 'base_type' is less accessible than 'derived_type'
 
+## Remarks
+
 A public type derives from a private type. If the public type is instantiated in a referenced assembly, members of the private base type will not be accessible.
 
 C4678 is only reachable using the obsolete compiler option **/clr:oldSyntax**. It is an error when using **/clr**, to have a base class that is less accessible that its derived class.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md
@@ -10,6 +10,8 @@ ms.assetid: 3cc74150-42a8-4116-94cd-4ef0fd6dcf32
 
 > '*member*' : could not import member
 
+## Remarks
+
 The compiler encountered a construct that it cannot support, that cannot be imported from metadata.
 
 Do not try to use the construct.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md
@@ -10,8 +10,12 @@ ms.assetid: e95f1a83-2784-4b05-ae94-12148e056e26
 
 > 'attribute' : WARNING!! attribute may cause invalid code generation: use with caution
 
+## Remarks
+
 You used an attribute that should not commonly be used.
 
+## Example
+
 The following sample generates C4684:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md
@@ -10,4 +10,6 @@ ms.assetid: 16e859b8-a8e8-4a0d-a1d0-37ec4e59a9d7
 
 > expecting '> >' found '>>' when parsing template parameters
 
+## Remarks
+
 A template definition was not terminated correctly.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md
@@ -10,6 +10,8 @@ ms.assetid: a027df3c-b2b8-4c49-8539-c2bc42db74e8
 
 > 'constraint': constraint list contains assembly private type 'type'
 
+## Remarks
+
 A constraint list has an assembly private type, meaning it will not be available when the type is accessed from outside the assembly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md
@@ -10,13 +10,15 @@ ms.assetid: 722133d9-87f6-46c1-9e86-9825453d6999
 
 > 'type' : type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead
 
+## Remarks
+
 The metadata file containing the original type definition is not referenced, and the compiler is using a local type definition.
 
 In the case where you are rebuilding *file*, C4691 can be ignored or turned off with pragma [warning](../../preprocessor/warning.md).  That is, if the file you are building is the same as the file where the compiler expects to find the type definition, you can ignore C4691.
 
 However, unexpected behavior can occur if the compiler uses a definition that is not from the same assembly that is referenced in metadata; CLR types are typed not only by the name of the type, but also by the assembly.  That is, a type Z from assembly z.dll is different from a type Z from assembly y.dll.
 
-## Examples
+## Example
 
 This sample contains the original type definition.
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md
@@ -10,6 +10,8 @@ ms.assetid: f6fb3acc-8228-491a-9c30-ce302d8a9c75
 
 > 'function': signature of non-private member contains assembly private native type 'native_type'
 
+## Remarks
+
 A type that is visible outside the assembly contains a member function whose signature contains a native type that is not visible outside the assembly. Therefore, the member function should not be called if its containing type is instantiated outside the assembly.
 
 For more information, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility).
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md
@@ -10,6 +10,8 @@ ms.assetid: c6585460-bc4a-4a15-9242-4cbfce53c961
 
 > 'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directives'
 
+## Remarks
+
 A symbol that was not defined was used with a preprocessor directive. The symbol will evaluate to false. To define a symbol, you can use either the [#define directive](../../preprocessor/hash-define-directive-c-cpp.md) or [/D](../../build/reference/d-preprocessor-definitions.md) compiler option.
 
 This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md
@@ -10,8 +10,12 @@ ms.assetid: e172b134-b1fb-4dfe-8e9d-209ea08b73c7
 
 > 'identifier' : this base class is inaccessible
 
+## Remarks
+
 The specified base class of an object to be thrown in a **`try`** block is not accessible. The object cannot be instantiated if it is thrown. Check that the base class is inherited with the correct access specifier.
 
+## Example
+
 The following sample generates C4670:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md
@@ -10,4 +10,6 @@ ms.assetid: 3ae1b9cd-e53e-41e7-a330-7238b7aa0679
 
 > 'identifier1' : ambiguous. First seen as 'identifier2'
 
+## Remarks
+
 The specified object to be thrown in a **`try`** block is ambiguous. The object cannot be disambiguated if it is thrown.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md
@@ -10,8 +10,12 @@ ms.assetid: 95626ec6-f05b-43c7-8b9a-a60a6f98dd30
 
 > throwing 'identifier' the following types will not be considered at the catch site
 
+## Remarks
+
 A throw object cannot be handled in the **`catch`** block. Each type that cannot be handled is listed in the error output immediately following the line containing this warning. Each unhandled type has its own warning. Read the warning for each specific type for more information.
 
+## Example
+
 The following sample generates C4673:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md
@@ -10,8 +10,12 @@ ms.assetid: 6e043f4c-c601-4b77-8130-920cff1d912e
 
 > 'class' : coclass does not specify a default interface
 
+## Remarks
+
 A [default](../../windows/attributes/default-cpp.md) interface was not specified for a class that was marked with the [coclass](../../windows/attributes/coclass.md) attribute. In order for an object to be useful, it must implement an interface.
 
+## Example
+
 The following sample generates C4680:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md
@@ -10,8 +10,12 @@ ms.assetid: a4e6d85f-3e21-4b45-a551-c23d3c554d3f
 
 > 'class' : coclass does not specify a default interface that is an event source
 
+## Remarks
+
 A [source](../../windows/attributes/source-cpp.md) interface was not specified for a class.
 
+## Example
+
 The following sample generates C4681:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md
@@ -10,10 +10,14 @@ ms.assetid: 858ea157-1244-4a61-85df-97b3de43d418
 
 > 'parameter' : no directional parameter attribute specified, defaulting to [in]
 
+## Remarks
+
 A method on a parameter in an attributed interface does not have one of the directional attributes: [in](../../windows/attributes/in-cpp.md) or [out](../../windows/attributes/out-cpp.md). The parameter defaults to in.
 
 This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information.
 
+## Example
+
 The following sample generates C4682:
 
 ```cpp
