Add "Remarks" and "Example" headings for warning references in range [C4081, C4120]

Rageking8 · web-flow · commit abf975297e53 · 2025-08-26T22:53:12.000+08:00
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md
@@ -10,6 +10,8 @@ ms.assetid: 6f656373-a080-4989-bbc9-e2f894b03293
 
 > expected 'token1'; found 'token2'
 
+## Remarks
+
 The compiler expected a different token in this context.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md
@@ -10,6 +10,8 @@ ms.assetid: e7d3344e-5645-4d56-8460-d1acc9145ada
 
 > expected 'token'; found identifier 'identifier'
 
+## Remarks
+
 An identifier occurs in the wrong place in a **#pragma** statement.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md
@@ -10,8 +10,12 @@ ms.assetid: 2bc6eb25-058f-4597-b351-fd69587b5170
 
 > expected pragma parameter to be 'on' or 'off'
 
+## Remarks
+
 The pragma requires an **on** or **off** parameter. The pragma is ignored.
 
+## Example
+
 The following sample generates C4085:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md
@@ -10,6 +10,8 @@ ms.assetid: 9248831b-22bf-47af-8684-bfadb17e94fc
 
 > expected pragma parameter to be '1', '2', '4', '8', or '16'
 
+## Remarks
+
 The pragma parameter does not have the required value (1, 2, 4, 8, or 16).
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md
@@ -10,6 +10,8 @@ ms.assetid: 546e4d57-5c8e-422c-8ef1-92657336dad5
 
 > 'function' : declared with 'void' parameter list
 
+## Remarks
+
 The function declaration has no formal parameters, but the function call has actual parameters. Extra parameters are passed according to the calling convention of the function.
 
 This warning is for the C compiler.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md
@@ -10,4 +10,6 @@ ms.assetid: 9bab817c-16b2-4324-be5e-f9cbb06b702e
 
 > 'function' : pointer mismatch in actual parameter 'number', formal parameter 'number'
 
+## Remarks
+
 The corresponding formal and actual parameters have a different level of indirection. The actual parameter is passed without change. The called function interprets its value as a pointer.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md
@@ -10,4 +10,6 @@ ms.assetid: 7c8f929b-9bf9-4063-9b7e-4affd98c1acc
 
 > 'function' : different types in actual parameter 'number', formal parameter 'number'
 
+## Remarks
+
 The corresponding formal and actual parameters have different types. The actual parameter is passed without change. The function casts the actual parameter to the type specified in the function definition.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md
@@ -10,12 +10,16 @@ ms.assetid: baad469d-23d4-45aa-ad9c-305b32d61e9a
 
 > 'operation' : different 'modifier' qualifiers
 
+## Remarks
+
 A variable used in an operation is defined with a specified modifier that prevents it from being modified without detection by the compiler. The expression is compiled without modification.
 
 This warning can be caused when a pointer to a **`const`** or **`volatile`** item is assigned to a pointer not declared as pointing to **`const`** or **`volatile`**.
 
 This warning is issued for C programs. In a C++ program, the compiler issues an error: [C2440](../../error-messages/compiler-errors-1/compiler-error-c2440.md).
 
+## Example
+
 The following sample generates C4090:
 
 ```c
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C4091"]
 
 > '*keyword*': ignored on left of '*type*' when no variable is declared
 
+## Remarks
+
 The compiler detected a situation where the user probably intended a variable to be declared, but the compiler wasn't able to declare the variable.
 
 ## Examples
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md
@@ -10,10 +10,14 @@ ms.assetid: abf3cca2-2f21-45d8-b025-6b513b00681e
 
 > 'a': interface is not a COM interface; will not be emitted to IDL
 
+## Remarks
+
 An interface definition that you may have intended as a COM interface was not defined as a COM interface and therefore will not be emitted to the IDL file.
 
 See [Interface Attributes](../../windows/attributes/interface-attributes.md) for a list attributes that indicate an interface is a COM interface.
 
+## Example
+
 The following sample generates C4096:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md
@@ -10,8 +10,12 @@ ms.assetid: 2525be51-fac2-43b2-b57c-3bbf1a2268f7
 
 > expected pragma parameter to be 'restore' or 'off'
 
+## Remarks
+
 A pragma was passed an invalid value.
 
+## Example
+
 The following sample generates C4097:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md
@@ -10,4 +10,6 @@ ms.assetid: 8c8aef1c-1639-44ec-a3dd-c0dfe9aa727d
 
 > 'function' : void function returning a value
 
+## Remarks
+
 A function declared with return type [void](../../cpp/void-cpp.md) has a **`return`** statement that returns a value. The compiler assumes the function returns a value of type **`int`**.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md
@@ -10,10 +10,14 @@ ms.assetid: 9021b514-375e-4d62-b261-ccb06f299e8e
 
 > 'filename' : alignment changed after including header, may be due to missing #pragma pack(pop)
 
+## Remarks
+
 Packing affects the layout of classes, and commonly, if packing changes across header files, there can be problems.
 
 Use #pragma [pack](../../preprocessor/pack.md)(pop) before exiting the header file to resolve this warning.
 
+## Example
+
 The following sample generates C4103:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md
@@ -10,6 +10,8 @@ ms.assetid: 9e8d95c6-e05d-47e0-bd87-78974b3cc06c
 
 > unexpected identifier 'identifier'
 
+## Remarks
+
 The pragma containing the unexpected identifier is ignored.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md
@@ -10,4 +10,6 @@ ms.assetid: ec7a7c4a-d2ee-431c-89dc-31b0f9bfd975
 
 > 'identifier1' differs in parameter lists from 'identifier2'
 
+## Remarks
+
 A function pointer is assigned to another function pointer, but the formal parameter lists of the functions do not agree. The assignment is compiled without modification.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md
@@ -10,8 +10,12 @@ ms.assetid: 3983e1c6-e8bb-46dc-8894-e1827db48797
 
 > same type qualifier used more than once
 
+## Remarks
+
 A type declaration or definition uses a type qualifier (**`const`**, **`volatile`**, **`signed`**, or **`unsigned`**) more than once. This causes a warning with Microsoft extensions (/Ze) and an error under ANSI compatibility (/Za).
 
+## Examples
+
 The following sample generates C4114:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md
@@ -10,6 +10,8 @@ ms.assetid: 25434ef3-061e-4252-91a5-0fe2a4b2ffb3
 
 > unnamed type definition in parentheses
 
+## Remarks
+
 A structure, union, or enumerated type with no name is defined in a parenthetical expression. The type definition is meaningless.
 
 In a C function call, the definition has global scope. In a C++ function call, the definition has the same scope as the function being called.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md
@@ -10,12 +10,16 @@ ms.assetid: c45aa281-4cc1-4dfd-bd32-bd7a60ddd577
 
 > macro name 'name' is reserved; 'Command' ignored
 
+## Remarks
+
 ### To fix by checking the following possible causes
 
 1. Trying to define or undefine a predefined macro.
 
 1. Trying to define or undefine the preprocessor operator **defined**.
 
+## Example
+
 The following sample generates C4117:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md
@@ -10,4 +10,6 @@ ms.assetid: 0052ce92-033a-4dce-a11e-b7388f4f5c2b
 
 > different bases 'base1' and 'base2' specified
 
+## Remarks
+
 Two based pointers are incompatible because they have different bases. The compiler cannot convert between them.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md
@@ -10,4 +10,6 @@ ms.assetid: 9faa9265-34b4-41dd-b7a2-e2f3969b1d91
 
 > based/unbased mismatch
 
+## Remarks
+
 The compiler cannot convert between the two pointers because one is based and the other is not.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md
@@ -10,6 +10,8 @@ ms.assetid: e68929fb-3a1c-4be7-920b-d5f79f534f99
 
 > untagged 'token' declared no symbols
 
+## Remarks
+
 The compiler detected an empty declaration using an untagged structure, union, or class. The declaration is ignored.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C4099"]
 
 > '*identifier*': type name first seen using '*object_type1*' now seen using '*object_type2*'
 
+## Remarks
+
 An object declared as a structure is defined as a class, or an object declared as a class is defined as a structure. The compiler uses the type given in the definition.
 
 ## Example
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md
@@ -9,7 +9,13 @@ helpviewer_keywords: ["C4101"]
 
 > '*identifier*': unreferenced local variable
 
-The local variable is never used. This warning occurs in the obvious situation:
+## Remarks
+
+The local variable is never used.
+
+## Examples
+
+This warning occurs in the obvious situation:
 
 ```cpp
 // C4101a.cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md
@@ -10,8 +10,12 @@ ms.assetid: 349f308a-daf3-48c6-bd53-6c38b73f8880
 
 > 'label' : unreferenced label
 
+## Remarks
+
 The label is defined but never referenced. The compiler ignores the label.
 
+## Example
+
 The following sample generates C4102:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md
@@ -10,4 +10,6 @@ ms.assetid: 396ae826-a892-4327-bd66-f4762376d72b
 
 > sizeof returns 'unsigned long'
 
+## Remarks
+
 The operand of the **`sizeof`** operator was very large, so **`sizeof`** returned an **`unsigned long`**. This warning occurs under the Microsoft extensions ([`/Ze`](../../build/reference/za-ze-disable-language-extensions.md)). Under ANSI compatibility (**`/Za`**), the result is truncated instead.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md
@@ -9,10 +9,14 @@ helpviewer_keywords: ["C4100"]
 
 > 'identifier' : unreferenced formal parameter
 
+## Remarks
+
 The formal parameter is not referenced in the body of the function. The unreferenced parameter is ignored.
 
 C4100 can also be issued when code calls a destructor on an otherwise unreferenced parameter of primitive type.
 
+## Example
+
 The following sample generates C4100:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md
@@ -9,10 +9,14 @@ helpviewer_keywords: ["C4112"]
 
 > `#line` requires an integer between 1 and '*line_count*'
 
+## Remarks
+
 The [#line](../../preprocessor/hash-line-directive-c-cpp.md) directive specifies an integer parameter that is outside the allowable range.
 
 If the specified parameter is less than 1, the line counter is reset to 1. If the specified parameter is greater than *number*, which is the compiler-defined limit, the line counter is unchanged. This diagnostic is a level 1 warning under ANSI C compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a level 4 warning with Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)).
 
+## Example
+
 The following sample generates C4112:
 
 ```cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md
@@ -10,6 +10,8 @@ ms.assetid: f3f94e72-fc49-4d09-b3e7-23d68e61152f
 
 > 'type' : named type definition in parentheses
 
+## Remarks
+
 The given symbol is used to define a structure, union, or enumerated type inside a parenthetical expression. The scope of the definition may be unexpected.
 
 In a C function call, the definition has global scope. In a C++ call, the definition has the same scope as the function being called.
