Merge pull request #5012 from MicrosoftDocs/main638481943700200737sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

docs/code-quality/c6031.md

@@ -1,10 +1,9 @@
 ---
 title: Warning C6031
 description: "Describes C++ Code Analysis warning C6031 and how to resolve it."
-ms.date: 10/04/2022
+ms.date: 4/5/2024
 f1_keywords: ["C6031", "RETVAL_IGNORED_FUNC_COULD_FAIL", "__WARNING_RETVAL_IGNORED_FUNC_COULD_FAIL"]
 helpviewer_keywords: ["C6031"]
-ms.assetid: 59e1ef0a-b3ca-4ffa-bcb3-ad2bd22ece22
 ---
 # Warning C6031
 
@@ -16,44 +15,48 @@ Warning C6031 indicates the caller doesn't check a function's return value for f
 
 In general, it isn't safe to assume that calls to functions requiring disk, network, memory, or other resources will succeed. The caller should always check the return value and handle error cases appropriately. Also consider using the `_Must_inspect_result_` annotation, which checks that the value is examined in a useful way.
 
+This warning applies to both C and C++ code.
+
 Code analysis name: `RETVAL_IGNORED_FUNC_COULD_FAIL`
 
 ## Example
 
 The following code generates warning C6031:
 
-```cpp
+```c
 #include <stdio.h>
-void f( )
+int main()
 {
-    fopen( "test.c", "r" ); // C4996, C6031 return value ignored
+    fopen("test.c", "r"); // C4996, C6031 return value ignored
     // code ...
 }
 ```
 
 To correct this warning, check the return value of the function as shown in the following code:
 
-```cpp
+```c
 #include <stdio.h>
-void f( )
+int main()
 {
-    FILE *stream;
-    if ( (stream = fopen( "test.c", "r" )) == NULL )
+    FILE* stream;
+    if ((stream = fopen("test.c", "r")) == NULL)
+    {
         return;
+    }
     // code ...
 }
 ```
 
 The following code uses safe function `fopen_s` to correct this warning:
 
-```cpp
+```c
 #include <stdio.h>
-void f( )
+int main()
 {
-    FILE *stream;
+    FILE* stream;
     errno_t err;
 
-    if ( (err = fopen_s( &stream, "test.c", "r" )) !=0 )
+    if ((err = fopen_s(&stream, "test.c", "r")) != 0)
     {
         // code ...
     }
@@ -64,23 +67,30 @@ This warning is also generated if the caller ignores the return value of a funct
 
 ```cpp
 #include <sal.h>
-_Check_return_ bool func();
+_Check_return_ bool func()
+{
+    return true;
+}
 
-void test_f()
+int main()
 {
-    func(); //  Warning C6031
+    func();
 }
 ```
 
 To correct the previous warning, check the return value as shown in the following code:
 
 ```cpp
 #include <sal.h>
-_Check_return_ bool func();
+_Check_return_ bool func()
+{
+    return true;
+}
 
-void test_f()
+int main()
 {
-    if ( func() ) {
+    if (func())
+    {
         // code ...
     }
 }
@@ -91,10 +101,12 @@ In cases where it's necessary to ignore the return value of a function, assign t
 ```cpp
 #include <tuple>
 #include <ctime>
+#include <cstdlib>
 #include <stdio.h>
-void f()
+
+int main()
 {
-    std::srand(static_cast(std::time(nullptr))); // set initial seed value to system clock
+    std::srand(static_cast<unsigned int>(std::time(nullptr))); // set initial seed value to system clock
     std::ignore = std::rand(); // Discard the first result as the few random results are always small.
     // ... 
 }

docs/error-messages/compiler-warnings/c4371.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4371"
-title: "Compiler Warning (level 3) C4371"
+description: "Learn more about: Compiler Warning (level 3, off) C4371"
+title: "Compiler Warning (level 3, off) C4371"
 ms.date: "01/31/2018"
 f1_keywords: ["C4371"]
 helpviewer_keywords: ["C4371"]
@@ -9,6 +9,6 @@ helpviewer_keywords: ["C4371"]
 
 > '*classname*': layout of class may have changed from a previous version of the compiler due to better packing of member '*member*'
 
-If your code relies on a particular memory layout for a class, warning C4371 tells you that the layout created by the current compiler may be different from the layout generated by previous versions of the compiler. This may be significant for serialization operations or operating system interfaces that rely on a particular memory layout. In most other cases, this warning is safe to ignore.
+Warning C4371 tells you that the layout created by the current compiler may be different from the layout generated by previous versions of the compiler. This difference may be significant for serialization operations or operating system interfaces that rely on a particular memory layout. In most other cases, this warning is safe to ignore.
 
 Warning C4371 is off by default. For more information, see [Compiler Warnings That Are Off By Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).

docs/error-messages/compiler-warnings/c4388.md

@@ -1,11 +1,11 @@
 ---
-title: "Compiler Warning (level 4) C4388"
-description: "Microsoft C/C++ compiler warning C4388, its causes and resolution."
+title: "Compiler Warning (level 4, off) C4388"
+description: "Learn more about: Compiler Warning (level 4, off) C4388"
 ms.date: 10/16/2020
 f1_keywords: ["C4388"]
 helpviewer_keywords: ["C4388"]
 ---
-# Compiler Warning (level 4) C4388
+# Compiler Warning (level 4, off) C4388
 
 > '*token*' : signed/unsigned mismatch
 

docs/error-messages/compiler-warnings/compiler-warning-c4335.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning C4335"
-title: "Compiler Warning C4335"
+description: "Learn more about: Compiler Warning (level 1) C4335"
+title: "Compiler Warning(level 1)  C4335"
 ms.date: "11/04/2016"
 f1_keywords: ["C4335"]
 helpviewer_keywords: ["C4335"]
-ms.assetid: e66467ad-a10b-4438-8c7c-e8e8d11d39bb
 ---
-# Compiler Warning C4335
+# Compiler Warning (level 1) C4335
 
-Mac file format detected: please convert the source file to either DOS or UNIX format
+> Mac file format detected: please convert the source file to either DOS or UNIX format
 
-The line termination character of the first line of a source file is Macintosh style ('\r') as opposed to UNIX ('\n') or DOS ('\r\n').
+The line termination character of the first line of a source file is the old Macintosh style ('\r') as opposed to UNIX ('\n') or DOS ('\r\n').
 
-This warning is always issued as an error.  See [warning](../../preprocessor/warning.md) pragma for information about how to disable this warning.  Also, this warning is only issued once per compiland. Therefore, if there are multiple `#include` directives that specify files in Macintosh format, C4335 will only be issued once.
+This warning is only issued once per translation unit. Therefore, if there are multiple `#include` directives that specify files in Macintosh format, C4335 is emitted once.
 
 One way to generate files in Macintosh format is by using the **Advanced Save Options** (on the **File** menu) in Visual Studio.
 

docs/error-messages/compiler-warnings/compiler-warning-c4368.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning C4368"
-title: "Compiler Warning C4368"
+description: "Learn more about: Compiler Warning (level 1, Error) C4368"
+title: "Compiler Warning (level 1, Error) C4368"
 ms.date: "11/04/2016"
 f1_keywords: ["C4368"]
 helpviewer_keywords: ["C4368"]
-ms.assetid: cb85bcee-fd3d-4aa5-b626-2324f07a4f1b
 ---
-# Compiler Warning C4368
+# Compiler Warning (level 1, Error) C4368
 
-cannot define 'member' as a member of managed 'type': mixed types are not supported
+> cannot define 'member' as a member of managed 'type': mixed types are not supported
 
-You cannot embed a native data member in a CLR type.
+You can't embed a native data member in a managed type.
 
-You can, however, declare a pointer to a native type and control its lifetime in the constructor and destructor and finalizer of your managed class. For more information see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers).
+You can, however, declare a pointer to a native type and control its lifetime in the constructor and destructor and finalizer of your managed class. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers).
 
 This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable C4368.
 

docs/error-messages/compiler-warnings/compiler-warning-c4394.md

@@ -1,20 +1,19 @@
 ---
-description: "Learn more about: Compiler Warning C4394"
-title: "Compiler Warning C4394"
+description: "Learn more about: Compiler Warning (level 1, Error) C4394"
+title: "Compiler Warning (level 1, Error) C4394"
 ms.date: "11/04/2016"
 f1_keywords: ["C4394"]
 helpviewer_keywords: ["C4394"]
-ms.assetid: 5de94de0-17e3-4e7c-92f4-5c3c1b825120
 ---
-# Compiler Warning C4394
+# Compiler Warning (level 1, Error) C4394
 
-'function' : per-appdomain symbol should not be marked with __declspec(dllexport)
+> 'function' : per-appdomain symbol should not be marked with __declspec(dllexport)
 
-A function marked with the [appdomain](../../cpp/appdomain.md) **`__declspec`** modifier is compiled to MSIL (not to native), and export tables ([export](../../windows/attributes/export.md) **`__declspec`** modifier) are not supported for managed functions.
+A function marked with the [appdomain](../../cpp/appdomain.md) **`__declspec`** modifier is compiled to MSIL (not native), and export tables ([export](../../windows/attributes/export.md) **`__declspec`** modifier) aren't supported for managed functions.
 
 You can declare a managed function to have public accessibility. For more information, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) and [Member visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Member_visibility).
 
-C4394 is always issued as an error.  You can turn off this warning with the `#pragma warning` or **/wd**; see [warning](../../preprocessor/warning.md) or [/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level)](../../build/reference/compiler-option-warning-level.md) for more information.
+C4394 is always issued as an error. You can turn off this warning or change its level with `#pragma warning` or **/wd**. For more information, see [warning](../../preprocessor/warning.md) or [/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level)](../../build/reference/compiler-option-warning-level.md).
 
 ## Example
 

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md

@@ -1,15 +1,14 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4264"
-title: "Compiler Warning (level 1) C4264"
+description: "Learn more about: Compiler Warning (level 4, off) C4264"
+title: "Compiler Warning (level 4, off) C4264"
 ms.date: "11/04/2016"
 f1_keywords: ["C4264"]
 helpviewer_keywords: ["C4264"]
-ms.assetid: 315a13c1-ca54-4a90-9d2b-dd996463af5d
 ---
-# Compiler Warning (level 1) C4264
+# Compiler Warning (level 4, off) C4264
 
-'virtual_function' : no override available for virtual member function from base 'class'; function is hidden
+> 'virtual_function' : no override available for virtual member function from base 'class'; function is hidden
 
 C4264 is always generated after [C4263](../../error-messages/compiler-warnings/compiler-warning-level-4-c4263.md).
 
-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.
+This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4392"
-title: "Compiler Warning (level 1) C4392"
+description: "Learn more about: Compiler Warning (level 1, Error) C4392"
+title: "Compiler Warning (level 1, Error) C4392"
 ms.date: "11/04/2016"
 f1_keywords: ["C4392"]
 helpviewer_keywords: ["C4392"]
-ms.assetid: 817806ad-06a6-4b9e-8355-e25687c782dc
 ---
-# Compiler Warning (level 1) C4392
+# Compiler Warning (level 1, Error) C4392
 
-'signature' : incorrect number of arguments for intrinsic function, expected 'number' arguments
+> 'signature' : incorrect number of arguments for intrinsic function, expected 'number' arguments
 
-A function declaration for a compiler intrinsic had the wrong number of arguments. The resulting image may not run correctly.
+A function declaration for a compiler intrinsic had the wrong number of arguments. The resulting image may not run correctly. To fix this warning, either correct the declaration or delete the declaration and `#include` the appropriate header file.
 
-To fix this warning, either correct the declaration or delete the declaration and simply #include the appropriate header file.
+This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable or change the warning level.
 
 The following sample generates C4392:
 

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md

@@ -1,20 +1,22 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4399"
-title: "Compiler Warning (level 1) C4399"
+description: "Learn more about: Compiler Warning (level 1, Error) C4399"
+title: "Compiler Warning (level 1, Error) C4399"
 ms.date: "11/04/2016"
 f1_keywords: ["C4399"]
 helpviewer_keywords: ["C4399"]
 ms.assetid: f58d9ba7-71a0-4c3b-b26f-f946dda8af30
 ---
-# Compiler Warning (level 1) C4399
+# Compiler Warning (level 1, Error) C4399
 
 > '*symbol*' : per-process symbol should not be marked with __declspec(dllimport) when compiled with /clr:pure
 
 ## Remarks
 
 The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017.
 
-Data from a native image or an image with native and CLR constructs can not be imported into a pure image. To resolve this warning, compile with **/clr** (not **/clr:pure**) or delete `__declspec(dllimport)`.
+Data from a native image or an image with native and common language runtime (CLR) constructs can't be imported into a pure image. To resolve this warning, compile with **/clr** (not **/clr:pure**) or delete `__declspec(dllimport)`.
+
+This warning can be issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable or change the warning level.
 
 ## Example
 

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4265"
-title: "Compiler Warning (level 3) C4265"
+description: "Learn more about: Compiler Warning (level 3, off) C4265"
+title: "Compiler Warning (level 3, off) C4265"
 ms.date: "11/04/2016"
 f1_keywords: ["C4265"]
 helpviewer_keywords: ["C4265"]
-ms.assetid: 20547159-6f30-4cc4-83aa-927884c8bb4c
 ---
-# Compiler Warning (level 3) C4265
+# Compiler Warning (level 3, off) C4265
 
-'class' : class has virtual functions, but destructor is not virtual
+> 'class' : class has virtual functions, but destructor is not virtual
 
 When a class has virtual functions but a nonvirtual destructor, objects of the type might not be destroyed properly when the class is destroyed through a base class pointer.
 
-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.
+This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
 The following sample generates C4265:
 

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md

@@ -1,15 +1,12 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4278"
-title: "Compiler Warning (level 3) C4278"
+description: "Learn more about: Compiler Warning (level 3 and level 4) C4278"
+title: "Compiler Warning (level 3 and level 4) C4278"
 ms.date: "08/27/2018"
 f1_keywords: ["C4278"]
 helpviewer_keywords: ["C4278"]
-ms.assetid: 4b6053fb-df62-4c04-b6c8-c011759557b8
 ---
-# Compiler Warning (level 3) C4278
+# Compiler Warning (level 3 and level 4) C4278
 
 > '*identifier*': identifier in type library '*tlb*' is already a macro; use the 'rename' qualifier
 
-When using [#import](../../preprocessor/hash-import-directive-cpp.md), an identifier in the typelib you are importing is attempting to declare an identifier *identifier*. However, this is already a valid symbol.
-
-Use the `#import` **rename** attribute to assign an alias to the symbol in the type library.
+The [`#import`](../../preprocessor/hash-import-directive-cpp.md) is attempting to import an identifier into the translation unit. However, there's already a symbol with that name. Use the `#import` **rename** attribute to assign an alias to the symbol in the type library.

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md

@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4287"
-title: "Compiler Warning (level 3) C4287"
+description: "Learn more about: Compiler Warning (level 3, off) C4287"
+title: "Compiler Warning (level 3, off) C4287"
 ms.date: "11/04/2016"
 f1_keywords: ["C4287"]
 helpviewer_keywords: ["C4287"]
-ms.assetid: 1bf3bff8-6402-4d06-95ba-431678a790a7
 ---
-# Compiler Warning (level 3) C4287
+# Compiler Warning (level 3, off) C4287
 
-'operator' : unsigned/negative constant mismatch
+> 'operator' : unsigned/negative constant mismatch
 
 An unsigned variable was used in an operation with a negative number.
 
-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.
+This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
 ## Example
 

docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md

@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4359"
-title: "Compiler Warning (level 3) C4359"
+description: "Learn more about: Compiler Warning (level 1 and level 3) C4359"
+title: "Compiler Warning (level 1 and level 3) C4359"
 ms.date: "11/04/2016"
 f1_keywords: ["C4359"]
 helpviewer_keywords: ["C4359"]
-ms.assetid: d8fe993c-ef82-45a0-a43d-c29f9d1bacdb
 ---
-# Compiler Warning (level 3) C4359
+# Compiler Warning (level 1 and level 3) C4359
 
-'type': actual alignment (8) is greater than the value specified in __declspec(align())
+> 'type': actual alignment (8) is greater than the value specified in __declspec(align())
 
-The alignment specified for a type is less than the alignment of the type of one of its data members.  For more information, see [align](../../cpp/align-cpp.md).
+The alignment specified for a type is less than the alignment of the type of one of its data members. For more information, see [align](../../cpp/align-cpp.md).
 
 ## Example